curl -X POST "https://api.contactship.ai/v1/tags" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "hot-lead",
    "color": "#FF5733",
    "label": "Hot Lead"
  }'

const response = await fetch('https://api.contactship.ai/v1/tags', {
  method: 'POST',
  headers: {
    'x-api-key': 'your-api-key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'hot-lead',
    color: '#FF5733',
    label: 'Hot Lead',
  }),
});
const tag = await response.json();
console.log(`Created tag: ${tag.id}`);

import requests

response = requests.post(
    'https://api.contactship.ai/v1/tags',
    headers={'x-api-key': 'your-api-key'},
    json={
        'name': 'hot-lead',
        'color': '#FF5733',
        'label': 'Hot Lead',
    },
)

tag = response.json()
print(f"Created tag: {tag['id']}")

{
  "id": "tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "hot-lead",
  "color": "#FF5733",
  "label": "Hot Lead",
  "organization_id": "org-f1e2d3c4-b5a6-7890-1234-567890abcdef",
  "created_at": "2026-04-05T12:00:00Z"
}