Skip to main content
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"
}
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

​
X-Team-ApiKey
string
header
required

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
Required array length: 1 - 25 elements
​
email
string<email>
required
​
firstName
string
​
lastName
string
​
company
string
​
customFields
object
​
tags
string[]
​
lists
string[]
​
newEmail
string<email>

New email when updating existing contact

Response

✅ All contacts identified successfully

​
status
string
Example:

"success"

​
message
string
Example:

"All contacts processed successfully"