> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactship.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Tag to Contact

> Assign a tag to a contact

Assigns an existing tag to a contact. Use [List Tags](/api-reference/endpoint/list-tags) to get the tag IDs available in your organization.

## Headers

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication. Found in your dashboard under API settings.
</ParamField>

## Path Parameters

<ParamField path="contactId" type="string" required>
  The UUID of the contact to tag.
</ParamField>

<ParamField path="tagId" type="string" required>
  The UUID of the tag to assign.
</ParamField>

## Response

Returns the created contact-tag association object.

## Error Codes

* `401 Unauthorized` — Invalid or missing API key
* `404 Not Found` — Contact or tag not found
* `500 Internal Server Error` — Server-side error

## Code Examples

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.contactship.ai/v1/contacts/c1d2e3f4-a5b6-7890-cdef-123456789012/tags/tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
    -H "x-api-key: your-api-key"
  ```

  ```javascript JavaScript theme={null}
  const contactId = 'c1d2e3f4-a5b6-7890-cdef-123456789012';
  const tagId = 'tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890';

  const response = await fetch(
    `https://api.contactship.ai/v1/contacts/${contactId}/tags/${tagId}`,
    {
      method: 'POST',
      headers: { 'x-api-key': 'your-api-key' },
    }
  );
  const result = await response.json();
  ```

  ```python Python theme={null}
  import requests

  contact_id = 'c1d2e3f4-a5b6-7890-cdef-123456789012'
  tag_id = 'tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890'

  response = requests.post(
      f'https://api.contactship.ai/v1/contacts/{contact_id}/tags/{tag_id}',
      headers={'x-api-key': 'your-api-key'},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json Example Response theme={null}
  {
    "id": "ct-x1y2z3a4-b5c6-7890-defg-hi1234567890",
    "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
    "tag_id": "tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "created_at": "2026-04-06T14:30:00Z"
  }
  ```
</ResponseExample>