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

No response body.

401

No response body.

403

No response body.

404

No response body.

429

No response body.

500

No response body.

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.