> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendify.dingstore.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a contact tag

> Create a static contact tag in the current account

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.

```http theme={null}
POST https://api.sendify.dingstore.cn/dmx/v2/tags
```

## Authentication

```http theme={null}
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 |

```json theme={null}
{ "name": "VIP-Customers", "description": "High-priority customers" }
```

## Request example

```bash theme={null}
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

```json theme={null}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.