Send Event

post

https://api3.appsflyer.com/inappevent/{app_id}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

app_id

string

required

Body Params

What if I can't send a device identifier? You may be unable to send the device identifier with the S2S event. In such cases, AppsFlyer will attempt to enrich the event postback with the device ID from the user's install (Note: Identifier enrichment doesn’t apply for IDFV). However, when the SDK sends install events without device identifiers, for example, when ATT (App Tracking Transparency) has not been implemented, the postback will not include the device ID. Not sending an advertising ID/device identifier can result in:

Postback issues: The media source will receive the postback but without a device identifier. As a result the media source can't associate the postback with a specific user.
Audiences segmentation and rule failure. Audiences rulesets require identifiers. It’s always best practice to send a device ID or customer user ID according to the ID type your ruleset uses, for every S2S event.
Incrementaliy: In order to be measured in Incrementality, S2S events must include the advertising ID in their payload (IDFA for iOS, GAID for Android).

advertising_id

string

oaid

string

amazon_aid

string

imei

string

appsflyer_id

string

required

customer_user_id

string

length ≤ 16

eventName

string

required

eventValue

json

required

app_version_name

string

app_store

string

eventTime

date-time

eventCurrency

string

enum

bundleIdentifier

string

sharing_filter

length ≥ 1

custom_dimension

string

app_type

string

enum

Allowed:

custom_data

json

string

aie

boolean

consent_data

app_set_id

object

Responses

Message	How to handle
Failed to Authenticate	Ensure that the authentication key is correct
appsflyer_id is a mandatory field	Make sure you pass the correct AppsFlyer ID in the JSON JSON is `stringified()` and formatted correctly
Bad request	When the request failed at least one of the validation criteria
Payload is missing or failed to parse	Make sure that the JSON is stringified and formatted correctly If more than one event is included in the JSON payload. Make sure to send one event per request.
app_id	`app_id` doesn't match the authentcation token Make sure that the app_id is correct.

200On receipt of a message, minimum data validation is performed. As such, you can get an OK response even though the event may not completely record in AppsFlyer

401 MessageHow to handleUnauthorizedWhen the key provided in the authentication header is not the <S2S_key> for this app

403 MessageHow to handleForbidden“Zero Package” does not accept attribution events

500 MessageHow to handleInternal Server ErrorVerify that the JSON is stringified() and formatted correctly