Import a new audience

⚠️

Important

All API V2 tokens generated before March 10, 2026, 19:00 UTC have been revoked. If your token was generated before this date, please regenerate it. Learn how.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required
  • To add devices: add
  • To remove devices: remove
  • To overwrite devices: overwrite
⚠️

Warning

Using the overwrite action incorrectly can result in unintentional data loss

Allowed:
Body Params
string
required

Unique key that identifies the audience

  • Use the same import_key for both the add and remove endpoints.
string
enum
required
Allowed:
devices
array of objects
required

Required identifiers:
For Android audiences: app_id + one of: gaid OR oiad OR imei OR cuid OR braze_id OR amplitude_id
For iOS audiences: app_id + one of: idfv OR cuid OR braze_id OR amplitude_id
Note: app_id is not required for as-is audiences.

devices*
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json