Create Tags (bulk)

POST

/tags/bulk

Create multiple tags at once.

Limit: maximum 100 tags per request.

For each item, provide exactly one of categoryId or categoryName.

Request

Header Params

Body Params application/json

Examples

Responses

🟢207

application/json

Description
Returned when the request contains a mix of successes and failures.

Bodyapplication/json

🟠400

🟠413

Request Example

Shell

JavaScript

Java

Swift

curl --location '/tags/bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "tags": [
        {
            "name": "VIP",
            "description": "High value clients",
            "order": 10,
            "categoryId": 1,
            "categoryName": "Marketing"
        }
    ]
}'

Response Example

207 - Success

{
    "results": [
        {
            "index": 0,
            "status": 201,
            "tag": {
                "id": 10,
                "name": "VIP",
                "description": "High value clients",
                "category": {
                    "id": 1,
                    "name": "Marketing"
                }
            }
        },
        {
            "index": 1,
            "status": 400,
            "error": {
                "error": "Provide exactly one of 'categoryId' or 'categoryName'."
            }
        },
        {
            "index": 2,
            "status": 404,
            "error": {
                "error": "Category not found"
            }
        },
        {
            "index": 3,
            "status": 409,
            "error": {
                "error": "Tag name already exists",
                "field": "name",
                "value": "VIP"
            }
        }
    ]
}

Modified at 2026-06-11 02:37:32

Get contact counts for all tags (grouped by category)

Get Tag categories