Create Tag
Create a new tag in your workspace.
Endpoint
POST https://api.campaignlark.com/v1/tags
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | required | The tag name. 1–64 characters. Must be unique within the workspace. |
description | string | optional | A short description of the tag. Max 96 characters. |
Sample Request
POST https://api.campaignlark.com/v1/tags
Content-Type: application/json
{
"name": "VIP",
"description": "VIP customers"
}
Response
Success — 201 Created
{
"data": {
"id": 1,
"name": "VIP",
"description": "VIP customers"
}
}
Errors
| Status | Message | Cause |
|---|---|---|
400 | Validation error | name is missing, empty, or exceeds 64 characters. |
400 | Validation error | description exceeds 96 characters. |
400 | Validation error | A tag with the same name already exists in the workspace. |
400 | Validation error | An import or export is currently in progress. |