Create Tag

POST

/v1/tags/service-account

Creates a new tag in the workspacs.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

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

Token URL: https://your-auth-server/connect/token

Scopes:

VoxaAPI-Access Voxa API as a service account

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Tag created successfully

Bodyapplication/json

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/tags/service-account' \
--header 'Content-Type: application/json' \
--data '{
    "Name": "VIP",
    "Icon": "star",
    "Description": "VIP customers",
    "IsPinned": true
}'

Response Example

{
    "Id": "38a5a5bb-dc30-49a2-b175-1de0d1488c43",
    "Name": "string",
    "Icon": "string",
    "IsPinned": true,
    "CreationTime": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-02-22 19:21:59

Get Conversation

Delete Tag