Remove tags from contacts

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

POST /v1/tags/contacts/remove

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.count

integer required

Example

{
  "error": false,
  "message": "string",
  "data": {
    "count": 0
  }
}

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/remove \
  --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/remove', {
  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/remove",
    headers={
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    json={
      "contactIds": [
        "00000000-0000-0000-0000-000000000000"
      ],
      "tagIds": [
        "00000000-0000-0000-0000-000000000000"
      ]
    }
)

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.

Create and assign tags to a contact

Create new tags and immediately assign them to a specific contact in a single operation. Tags that already exist with the same name are reused.