Create Tag

Create a new tag for organizing bookings.

Endpoint

POST /v1/tags

Authentication

Requires an API key with the bookings:write scope.

Request Body

Field	Type	Required	Description
name	string	Yes	Tag name (max 255 characters, must be unique per supplier)

Example Request

curl -X POST "https://app.equipdash.com/api/v1/tags" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Priority"
  }'

Response

Success (201 Created)

{
  "data": {
    "id": 4,
    "name": "Priority",
    "created_at": "2026-01-15T12:00:00+00:00",
    "updated_at": "2026-01-15T12:00:00+00:00"
  },
  "meta": {
    "request_id": "req_def456",
    "timestamp": "2026-01-15T12:00:00+00:00"
  }
}

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks bookings:write scope
422	validation_error	Invalid request data (e.g., duplicate name)