Create a contact tag - Sendify Help Center

Creates a static contact tag for the user associated with the API Key. The returned tag ID can be used in a campaign’s tagIds recipient scope.

POST https://api.sendify.dingstore.cn/dmx/v2/tags

Authentication

Authorization: Bearer YOUR_API_KEY

Request body

Field	Type	Required	Description
`name`	`string`	Yes	1–20 characters; Chinese characters, letters, numbers, underscores, and hyphens are allowed
`description`	`string`	No	Optional tag description

{ "name": "VIP-Customers", "description": "High-priority customers" }

Request example

curl -X POST "https://api.sendify.dingstore.cn/dmx/v2/tags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"VIP-Customers","description":"High-priority customers"}'

Success response

{
  "tag": {
    "id": "tag-vip",
    "name": "VIP-Customers",
    "description": "High-priority customers"
  }
}

Error responses

HTTP status	Meaning
`400`	Invalid name, duplicate name, or tag limit reached
`401`	Missing or invalid Bearer API Key
`403`	The API Key lacks permission
`500`	Tenant missing or internal service error