Contact Tags

Tags are short labels you can assign to contacts for segmentation and filtering. Tag names must be unique per organisation. Tag creation is subject to the max_contact_tags plan limit.

List Tags

Return all contact tags for your organisation, sorted alphabetically.

GET/v2.0/contacts/tags

Code Example

curl -X GET "https://api.sendiee.com/v2.0/contacts/tags" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response — 200 OK

{
  "success": true,
  "data": [
    {
      "_id": "6640fa2b3e4a1c0012def001",
      "name": "Hot Lead",
      "createdAt": "2026-02-10T08:00:00.000Z",
      "updatedAt": "2026-02-10T08:00:00.000Z"
    },
    {
      "_id": "6640fa2b3e4a1c0012def002",
      "name": "VIP Customer",
      "createdAt": "2026-02-15T10:00:00.000Z",
      "updatedAt": "2026-02-15T10:00:00.000Z"
    }
  ],
  "meta": {
    "total": 2
  }
}

Try It — List

Try it — API Playground

Create Tag

Create a new contact tag. Tag names must be unique within your organisation.

POST/v2.0/contacts/tags

Body Parameters

ParameterTypeDescription
namestringTag name. Must be unique within the organisation.

Code Example

curl -X POST "https://api.sendiee.com/v2.0/contacts/tags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Hot Lead" }'

Response — 201 Created

{
  "success": true,
  "message": "Tag created successfully.",
  "data": {
    "_id": "6640fa2b3e4a1c0012def003",
    "name": "Hot Lead",
    "createdAt": "2026-04-14T09:00:00.000Z",
    "updatedAt": "2026-04-14T09:00:00.000Z"
  }
}

Try It — Create

Try it — API Playground

Rename Tag

Rename an existing contact tag. The new name must be unique within your organisation.

PUT/v2.0/contacts/tags/:tagId

Path Parameters

ParameterTypeDescription
tagIdstringMongoDB ObjectId of the tag

Body Parameters

ParameterTypeDescription
namestringNew tag name. Must be unique within the organisation.

Code Example

curl -X PUT "https://api.sendiee.com/v2.0/contacts/tags/6640fa2b3e4a1c0012def003" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Warm Lead" }'

Response — 200 OK

{
  "success": true,
  "message": "Tag updated successfully.",
  "data": {
    "_id": "6640fa2b3e4a1c0012def003",
    "name": "Warm Lead",
    "createdAt": "2026-04-14T09:00:00.000Z",
    "updatedAt": "2026-04-14T11:45:00.000Z"
  }
}

Delete Tag

Delete a contact tag from your organisation.

DELETE/v2.0/contacts/tags/:tagId

Path Parameters

ParameterTypeDescription
tagIdstringMongoDB ObjectId of the tag

Code Example

curl -X DELETE "https://api.sendiee.com/v2.0/contacts/tags/6640fa2b3e4a1c0012def003" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response — 200 OK

{
  "success": true,
  "message": "Tag deleted successfully.",
  "data": {
    "tagId": "6640fa2b3e4a1c0012def003",
    "name": "Warm Lead"
  }
}