POST a tag

POST /user-api/v1/tags

Headers

HeaderValue
Content-Typeapplication/json
x-rolodex-api-keyf1e2d3c4b5a697...

Required Fields

name
string

Tag name (1-50 characters)

Request

{
  "name": "VIP Client",
  "contacts": ["contact_123", "contact_456"],
  "companies": ["company_789"],
  "tasks": ["task_101"]
}

Response

{
  "data": {
    "id": "tag_99999",
    "name": "VIP Client",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "contacts": [
      {
        "id": "contact_123",
        "full_name": "John Doe",
        "image_url": "<https://example.com/avatar1.jpg>"
      },
      {
        "id": "contact_456",
        "full_name": "Jane Smith",
        "image_url": "<https://example.com/avatar2.jpg>"
      }
    ],
    "companies": [
      {
        "id": "company_789",
        "name": "Tech Corp",
        "logo_url": "<https://example.com/logo.png>"
      }
    ],
    "tasks": [
      {
        "id": "task_101",
        "body": "Schedule meeting"
      }
    ]
  }
}