Create Tag

POST

https://platform-api.convirza.com/v3/tag

Miscellaneous

Last modified:2026-04-03 14:27:57

Creates one or more call tags for an organization. Tags created here become available for agents to apply to call records.

Single vs. bulk creation
The request body accepts either a single tag object or an array of tag objects, allowing bulk creation in one API call.

Duplicate handling
If a tag with the same name already exists in the organization, it is not re-created. The response separates successfully created tags from duplicates, so clients can distinguish new additions from pre-existing ones.

Response
Returns an object with two arrays: created (new tag IDs and names) and duplicates (tags that already existed).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Tags created successfully

Body

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://platform-api.convirza.com/v3/tag' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tag": {
        "org_unit_id": 70035,
        "tagList": [
            {
                "tag_name": "Sales Lead"
            },
            {
                "tag_name": "Hot Lead"
            }
        ]
    }
}'

Response Example

201 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "inserted_tags": [
            {
                "tag_id": 456,
                "tag_name": "Sales Lead"
            }
        ],
        "existing_tags": [
            "Hot Lead"
        ]
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-04-03 14:27:57

List Tags

Update Tag