Add tags to contacts

Assign one or more tags to one or more contacts. Accepts arrays of tag IDs and contact IDs to create the associations.

POST /v1/tags/contacts/add

Request body

Content-Type: application/json

contactIds

array<string (uuid)> required

tagIds

array<string (uuid)> required

Example

{
  "contactIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Responses

200 — Successful response

Content-Type: application/json

error

boolean required

message

string required

data

object required

data.tags

array<object> required

data.tags[].user_id

string required

data.tags[].contact_id

string (uuid) required

data.tags[].tag_id

string (uuid) required

Example

{
  "error": false,
  "message": "string",
  "data": {
    "tags": [
      {
        "user_id": "string",
        "contact_id": "00000000-0000-0000-0000-000000000000",
        "tag_id": "00000000-0000-0000-0000-000000000000"
      }
    ]
  }
}

400 — Request body failed validation.

Content-Type: application/json

(body)

any

401 — Missing or invalid API key.

Content-Type: application/json

(body)

any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)

any

404 — Resource does not exist.

Content-Type: application/json

(body)

any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)

any

429 — Rate limit exceeded.

Content-Type: application/json

(body)

any

500 — Unexpected server error.

Content-Type: application/json

(body)

any

Code samples

curl https://api.prod.getdex.com/v1/tags/contacts/add \
  --request POST \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "contactIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}'

fetch('https://api.prod.getdex.com/v1/tags/contacts/add', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    contactIds: ['00000000-0000-0000-0000-000000000000'],
    tagIds: ['00000000-0000-0000-0000-000000000000']
  })
})

requests.post(
    "https://api.prod.getdex.com/v1/tags/contacts/add",
    headers={
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    json={
      "contactIds": [
        "00000000-0000-0000-0000-000000000000"
      ],
      "tagIds": [
        "00000000-0000-0000-0000-000000000000"
      ]
    }
)

List tags

Retrieve all tags for the authenticated user. Tags are labels that can be attached to contacts for flexible categorization (e.g., "VIP", "Investor", "Met at conference").

Remove tags from contacts

Remove one or more tag assignments from one or more contacts. The tags and contacts themselves are not deleted.