Add Tags to Call

POST

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

Calls

Last modified:2026-07-24 13:10:44

Adds one or more tags to a specific call. Tags are used to categorize and organize calls for easier filtering and reporting.

Behavior:

If a tag name does not exist in your account, it will be created automatically in your current organizational unit

Existing tags from your accessible groups within the same account will be reused

Duplicate tags for the same call are ignored (returns tags_added: 0)

Tag names are case-insensitive

Maximum 100 characters per tag name

Blank tags are rejected

Account-Level Isolation:

Tags are scoped to your account (billing_id) — you cannot access tags from other accounts

If a tag name exists in another group within your account that you don't have access to, the request will fail with "This tag(s) already exists."

This prevents accidental tag conflicts across organizational boundaries

Authorization:
User must have access to the organizational unit that owns the call.

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 added successfully

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://platform-api.convirza.com/v3/conversations/calls/tag' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "call_id": 123456,
    "tags": [
        "sales",
        "follow-up",
        "qualified-lead"
    ]
}'

Response Example

201 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "message": "Successfully added tag(s).",
        "tags_added": 3
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-07-24 13:10:44

Upload Call Recording

Get SMS Conversations