Assign Tags

Add one or more tags to a contact. Tags drive segmentation, automation, and reporting in Splashify Pro — assign them from your own systems (CRM stage changes, purchase events, lifecycle triggers) to keep segments in sync.

Existing tags on the contact are preserved; new tags are merged in and de-duplicated.

Endpoint


POST https://api.splashifypro.com/api/v1/public/contacts/tags

Headers

Header	Value
`Authorization`	`Basic YOUR_API_KEY`
`Content-Type`	`application/json`

Request body

Identify the contact by either phone_number or contact_id.


{
  "phone_number": "919876543210",
  "tags": ["vip", "renewed"]
}

Field	Required	Notes
`phone_number`	one of	Customer’s phone in country-code + number format (no `+`).
`contact_id`	one of	The contact’s UUID. Takes precedence over `phone_number`
`tags`	yes	Array of tag strings to add. Empty / whitespace-only entries are ignored

Example


curl -X POST https://api.splashifypro.com/api/v1/public/contacts/tags \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "919876543210",
    "tags": ["vip", "renewed"]
  }'

Successful response — `200 OK`


{
  "result": true,
  "message": "Tags assigned successfully",
  "tags": ["lead", "website", "vip", "renewed"]
}

tags is the contact’s full tag list after the merge, so you can store it directly.

Error response — `404 Not Found`


{
  "result": false,
  "message": "Contact not found"
}

Status codes

Code	Meaning
`200 OK`	Tags assigned
`400 Bad Request`	`tags` missing/empty, or no valid contact identifier
`401 Unauthorized`	API key invalid or missing
`404 Not Found`	No active contact matches the identifier
`429 Too Many Requests`	Rate limit exceeded

Implementation tips

Idempotent — re-assigning a tag the contact already has is a no-op, and the response still returns the full list.
Assigning a tag can trigger Meta Conversions API events if you’ve configured a lead/purchase trigger on that tag (Settings → Meta Ads) — the event fires automatically.
Tag changes sync to the contact’s open conversation, so the inbox reflects them in real time.