Add tags to a contact

Adds one or more existing workspace tags to a contact. If the contact does not exist yet it is created. Tags must already exist in the workspace; create them from the dashboard first.

POST

https://api.zacx.io/v1/tags/add

View as Markdown

Authorisation

bearerAuthHTTPrequired

Request bodyJSON

phoneNumberstringrequired
The contact's phone number with country code. A leading + is accepted.

Example: "+11234567890"
tagsarray ofstringrequired
Tag names.

Example: ["test-tag"]

Returns

200

The tags were processed.

JSON

statusstringrequired
messagestringrequired
codeoptionalstring
Present when the call succeeded but changed nothing, for example TAG_ALREADY_ASSOCIATED.

404

The tag does not exist in this workspace.

JSON

statusstringrequired
codestringrequired
Stable machine-readable error code.
messagestringrequired
Human-readable explanation.

curl --request POST \ --url https://api.zacx.io/v1/tags/add \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "phoneNumber": "+11234567890", "tags": [ "test-tag" ] } '