Send Event

post

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🚧
JSON payload limitation JSON payload size: up to 1KB

📘
Encode URLs - Encode (percent) code reserved characters before forming the method URL.

Path Params

app_id

string

required

Body Params

What if I can't send a device identifier?

You may be unable to send the identifier for a reason out of your control, for example, because the user has limited ad tracking (LAT) or uses iOS 14, and did not give ATT consent. Not sending an advertising ID/device identifier can result in: Postback issues: The media source will receive the postback but without a device identifier; consequently the media source can't associate it with a 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.

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.

What if I can't send a device identifier?

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 <dev_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