Skip to main content
POST
/
contact
/
identify
curl --request POST \
  --url https://api.sendx.io/api/v1/rest/contact/identify \
  --header 'Content-Type: application/json' \
  --header 'X-Team-ApiKey: <api-key>' \
  --data '{
  "email": "john.doe@example.com"
}'
{
  "status": "200",
  "message": "OK"
}
The Identify API Method is used to attach data to a visitor and manage contact creation or updates.

​
Example Request:

{
  "email": "john.doe@gmail.com",
  "firstName": "John",
  "lastName": "Doe",
  "birthday": "1989-03-03",
  "customFields": {
    "Designation": "Software Engineer",
    "Age": "27",
    "Experience": "5"
  },
  "tags": ["Developer", "API Team"]
}
  • 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
​
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

✅ Contact identified successfully

​
status
string
Example:

"200"

​
message
string
Example:

"OK"

⌘I