Skip to main content
POST
/
contact
/
track
Track contact
curl --request POST \
  --url https://api.sendx.io/api/v1/rest/contact/track \
  --header 'Content-Type: application/json' \
  --header 'X-Team-ApiKey: <api-key>' \
  --data '
{
  "email": "test@example.com",
  "addTags": [
    "new",
    "cool"
  ],
  "removeTags": [
    "old",
    "bad"
  ]
}
'
{
  "status": "200",
  "message": "OK"
}
The Track API Method is used to track a contact’s actions by managing tags.

​
Example Requests:

Add tags: 
{
  "addTags": ["blogger", "female"]
}
Add and remove tags: 
{
  "addTags": ["paid user"],
  "removeTags": ["trial user"]
}
Automation rules can be triggered based on tag additions or removals, e.g.:
  • On user registration tag, start onboarding drip campaigns.
  • On account upgrade, start account expansion drip campaigns.
  • On removal of the trial user tag, initiate upsell campaigns.

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
​
addTags
string[]

Tags to add to contact

​
removeTags
string[]

Tags to remove from contact

​
email
string

Email address of the contact

Example:

"test@example.com"

Response

✅ Contact tracked successfully

​
status
string
Example:

"200"

​
message
string
Example:

"OK"