ContactsContact Tags

Create Contact Tag

Create a new contact tag in your project.

Create a new tag for categorizing contacts in your project.

Required: Contacts > Write

POST
/createContactTag

Authorization

bearerToken

AuthorizationBearer <token>

API token for YourGPT Public APIs. Create tokens in Settings > API Tokens in your YourGPT dashboard.

In: header

Request Body

application/json

project_uid*string

Your project's unique identifier.

name*string

Tag name.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.yourgpt.ai/chatbot/v1/createContactTag" \  -H "Content-Type: application/json" \  -d '{    "project_uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",    "name": "enterprise"  }'
{
  "type": "RXSUCCESS",
  "data": {
    "id": 501,
    "name": "vip",
    "project_id": 12345,
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:30:00.000Z"
  }
}
{
  "type": "RXERROR",
  "message": "Invalid params"
}
{
  "type": "RXERROR",
  "message": "Invalid or revoked API token"
}
{
  "type": "RXERROR",
  "message": "You do not have permission to perform this action"
}