Tags

List and create organization-level tags used to label contacts

Get Organization Tags

get

Get all tags defined at organization level. Supports pagination with page and page_size query parameters.

Authorizations

OrganizationApiToken

AuthorizationstringRequired

Organization API Token.

Paste only your token in the field below — the Bearer prefix is added automatically by the docs UI and in every generated code sample. The final header sent is:

Authorization: Bearer {orgId}.{secretToken}

Token format: {orgId}.{secretToken} — example: 15c94c3c-1873-4a09-bfbb-03357c29ea50.abc123xyz.

JWT tokens are NOT accepted.

Query parameters

pageintegerOptional

Page number

page_sizeintegerOptional

Number of results per page (max 100)

Responses

200

List of organization-level tags

application/json

Other propertiesanyOptional

get/api/account/tags

HTTPcURLJavaScriptPython

GET /api/account/tags HTTP/1.1
Host: api.agentalk.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of organization-level tags

{
  "tags": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "vip",
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ]
}

Create Organization Tag

post

Create a new tag at organization level. Tag names must be unique per organization.

Authorizations

OrganizationApiToken

AuthorizationstringRequired

Organization API Token.

Paste only your token in the field below — the Bearer prefix is added automatically by the docs UI and in every generated code sample. The final header sent is:

Authorization: Bearer {orgId}.{secretToken}

Token format: {orgId}.{secretToken} — example: 15c94c3c-1873-4a09-bfbb-03357c29ea50.abc123xyz.

JWT tokens are NOT accepted.

Body

application/json

namestringRequired

Tag name (required)

Example: vip

colorstringOptional

Tag color (optional)

Example: #00B894

Responses

201

Tag created successfully

application/json

Other propertiesanyOptional

409

Tag with this name already exists

application/json

post/api/account/tags

HTTPcURLJavaScriptPython

POST /api/account/tags HTTP/1.1
Host: api.agentalk.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "name": "vip",
  "color": "#00B894"
}

{
  "tag": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "vip",
    "created_at": "2025-01-01T00:00:00Z",
    "updated_at": "2025-01-01T00:00:00Z"
  }
}