Tags API

Tags are tenant-scoped labels you can attach to contacts and leads. The frontend renders them with their color.

Endpoints

Schema

{ "id": "tag_01H...", "tenantId": "tnt_01H...", "name": "VIP", "color": "#10B981", "usageCount": 24, "createdAt": "...", "updatedAt": "..." }

Every response uses the standard envelope:

{
  "success": true,
  "data": { /* resource or array */ },
  "meta": { "total": 100, "cursor": "...", "hasMore": true },
  "error": { "code": "ERROR_CODE", "message": "Human readable" }
}

error is omitted on success; meta is omitted when not paginating.

Rate Limits

Subject to the standard 200 req/min/tenant authenticated limit. See [Rate Limits](/docs/api-reference/rate-limits) for full details and the per-endpoint overrides.