Create Tag

The Create Tag endpoint adds a new tag to your organization. Tags are a flat, organization-wide label set; once created, a tag can be attached to templates (with Edit Template Metadata) or variables to make them easier to filter and organize.

When to use it

Use this endpoint to build a tag picker that lets users create new tags on the fly, or to seed a starting set of tags when provisioning an organization.

Example request

curl -X POST "https://api.turbodocx.com/Tag" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"label": "legal"}'

Example response

{
  "data": {
    "results": {
      "id": "7c1a0b52-9e88-4f0d-b3a2-1d4c6f8e2a90",
      "label": "legal",
      "isActive": true,
      "orgId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "createdBy": "f5e6d7c8-9a0b-4c1d-2e3f-4a5b6c7d8e9f",
      "createdOn": "2026-05-01T14:22:10.000Z",
      "updatedOn": "2026-05-01T14:22:10.000Z"
    }
  }
}

Common errors

Status	When	Response body
401	Missing or invalid API key/token, or the organization cannot be resolved	Empty (status only)
403	The key's role is not administrator, contributor, or user	Empty (status only)
400	label is missing or not between 1 and 255 characters	{ "message", "type": "ValidationError", "data": { "errors": [...] } }

Related endpoints

• Read Tag to list existing tags before creating a duplicate

• Update Tag to rename a tag

• Delete Tags (by IDs) to remove tags you no longer need

  POST

  /Tag