Push API V1.0 real-time raw data (deprecated)

 Deprecated version

This document describes a deprecated version of Push API. The sunset date of Push API V1.0 is August 31, 2020.  If you have not yet implemented Push API use Push API V2.0.  

Existing users - Migrate to Push API V2.0 

Push API V1.0 real-time raw data

Push API enables advertisers to receive raw data messages via an HTTP request from AppsFlyer to any endpoint. A push API message can be sent upon every successful installation, in-app event or retargeting event, whether organic or not.

Messages are sent in near real-time, meaning that usually they are sent within a few seconds of the performed action, but may take up to two minutes.

The data is sent, by default, via an http POST or GET method and is JSON formatted.

For the complete list of fields and message examples click here.

For field descriptions please read this.

Who should use push API?

  1. Advertisers who need accurate attribution data sent to their servers in near real-time
    Combine your users' data with detailed AppsFlyer's attribution data as it happens, especially for analytics and segmentation purposes. [If you base your app's flow on the attribution data in real time, i.e. within 5 seconds of the first app open, it is better to use AppsFlyer's conversion data API instead]
  2. Advertisers with complex databases
    If you need your data to be sent to different databases in your system to collect install/in-app event/organic/non-organic data, Push API can do this with a simple 2-minute configuration saving you precious developing resources.
  3. Advertisers working with external data collection platforms
    With Push API you can send any install or event data to external systems by simply supplying their endpoint URL


  • The Push API is an AppsFlyer premium feature, which can be purchased as part of the API Access package. The package is available for free to advanced account tiers.
    Please contact your CSM or AppsFlyer's support if you require more details.
  • Click here for information about selecting the best data APIs for you
  • Click here to learn about the benefits of using Push API together with Pull API
Was this article helpful?



Please sign in to leave a comment.