v1

latestOpenAPI 3.1.0MIT2026-07-243952451019.0 KB

Contacts::Tag

Create Tag

Add a new Contact Tag to your Workspace

post/workspaces/{workspace_id}/contacts/tags

Path parameters

workspace_idinteger required

Request body

Example request

{
  "contacts_tag": {
    "contacts_tag": {
      "name": "Example Tag",
      "color": "#FF5733"
    }
  }
}

Response

Created

idinteger

Tag ID

public_idstring nullable

Tag public ID

workspace_idinteger

Workspace ID

namestring

Name

colorstring

Color

created_atstring date-time nullable

Created at datetime

updated_atstring date-time nullable

Updated at datetime

Example response

{
  "id": 4,
  "public_id": "LutgGM",
  "workspace_id": 42000,
  "name": "Example Tag",
  "color": "#00FF00",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}