curl --request POST \
--url https://api.sendx.io/api/v1/rest/contact/identify/bulk \
--header 'Content-Type: application/json' \
--header 'X-Team-ApiKey: <api-key>' \
--data '
[
{
"email": "john.doe@example.com"
},
{
"email": "alice@example.com"
}
]
'{
"status": "success",
"message": "All contacts processed successfully"
}{
"status": 401,
"message": "The Team ID or API Key specified is not valid"
}{
"status": "error",
"message": "Request body is not in proper format"
}{
"status": "error",
"message": "Internal server error occurred"
}Getting Started
Identify Bulk Contacts
Endpoint for identifying bulk contacts. Creates or updates multiple contacts in a single request.
🎯 Key Features:
- Creates contact if doesn’t exist
- Updates if email already exists
- Supports custom fields and tags
- Supports batch operations (max 25 contacts per request)
POST
/
contact
/
identify
/
bulk
curl --request POST \
--url https://api.sendx.io/api/v1/rest/contact/identify/bulk \
--header 'Content-Type: application/json' \
--header 'X-Team-ApiKey: <api-key>' \
--data '
[
{
"email": "john.doe@example.com"
},
{
"email": "alice@example.com"
}
]
'{
"status": "success",
"message": "All contacts processed successfully"
}{
"status": 401,
"message": "The Team ID or API Key specified is not valid"
}{
"status": "error",
"message": "Request body is not in proper format"
}{
"status": "error",
"message": "Internal server error occurred"
}The Identify API Method is used to attach data to a visitor and manage contact creation or updates.
- Tags and custom fields that do not exist are created automatically.
- Existing tags and custom fields are updated with the new data.
- Properties are additive: no data is removed based on subsequent Identify calls.
Authorizations
Team API key for authentication. Find your API key in SendX Settings → Team API Key.
Example:
X-Team-ApiKey: your_team_api_key_here
Body
application/json
Was this page helpful?