Identify Bulk Contacts

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"
}

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

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

string<email>

required

firstName

string

lastName

string

company

string

customFields

object

Show child attributes

Response

✅ All contacts identified successfully

status

string

Example:

"success"

message

string

Example:

"All contacts processed successfully"

API Reference

Getting Started

Email Sending

Contact

Events

Campaign

List

Tag

Sender

Template

Custom Field

Domain

Webhook

Report

Post

Post Category

Post Tag

Team Member

Identify Bulk Contacts

Authorizations

Body

Response