Upsert Contacts [Async]

The Upsert Contact API enables clients to update or create/insert (upsert) one or more contacts within a single request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
  • Upsert API supports both identified and anonymous contact types, providing flexibility for various data ingestion scenarios
  • Each contact can include core identifiers such as email, mobile, and identity, along with system or custom attributes and optional audience assignments.

The API checks whether each contact already exists and takes the appropriate action:

  • If the contact exists: Updates the existing contact.
  • If the contact does not exist: Creates a new contact.
  • If the contact is anonymous: Uses the configured matching rules to identify an existing contact.
Body Params

All necessary parameters should be passed in the request body in JSON format. Click '+' icon to enter a value for each parameter

data
object
required
Headers
string
required

API key for authentication. You must have unique & valid api-key

Responses

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