Saltar al contenido principal
POST
/
v1
/
contacts
/
{contactId}
/
tags
/
{tagId}
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"

{
  "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"
}
Assigns an existing tag to a contact. Use List Tags to get the tag IDs available in your organization.

​
Headers

​
x-api-key
string
requerido
Your API key for authentication. Found in your dashboard under API settings.

​
Path Parameters

​
contactId
string
requerido
The UUID of the contact to tag.
​
tagId
string
requerido
The UUID of the tag to assign.

​
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

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"

{
  "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"
}