Skip to main content
POST
/
v1
/
people
/
{id}
/
tags
Add tags to contact
curl --request POST \
  --url https://api.clientcommander.com/v1/people/{id}/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tags": [
    "VIP",
    "Hot Lead"
  ]
}
'
{
  "meta": {
    "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z",
    "version": "1.0.0"
  },
  "data": {
    "count": 123,
    "person": {
      "id": "jd79abc123def",
      "firstName": "John",
      "lastName": "Doe",
      "fullName": "John Doe",
      "createdAt": "2023-11-15T10:00:00Z",
      "emails": [
        {
          "value": "john@example.com",
          "type": "work",
          "isPrimary": false
        }
      ],
      "phones": [
        {
          "value": "+15551234567",
          "type": "mobile",
          "status": "Valid",
          "isPrimary": true,
          "isBad": true
        }
      ],
      "assignedAgentId": "<string>",
      "assignedAgentName": "Jane Smith",
      "assignedAgentEmail": "jsmith@example.com",
      "stageId": "<string>",
      "stageName": "Lead",
      "source": "Website Signup",
      "tags": "VIP, Hot Lead, Referral",
      "price": 450000,
      "timeframe": "3-6 months",
      "background": "<string>",
      "relationship": false,
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.clientcommander.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key for authentication using Bearer token scheme.

How to get your API key:

  1. Log into Client Commander
  2. Go to Admin > API Keys
  3. Click Create API Key
  4. Copy the key and use it in the Authorization header:
Authorization: Bearer ccmd_live_your_key_here

Path Parameters

id
string
required

Contact ID

Pattern: ^[a-zA-Z0-9_-]{8,}$

Body

application/json
tags
string[]
required
Required array length: 1 - 20 elements
Required string length: 1 - 50
Example:
["VIP", "Hot Lead"]

Response

Tags added successfully

meta
object
required
data
object