1. Tags API
Hatif
  • Account API
    • Service Login
      POST
  • Channels API
    • Get Channels
      GET
  • Whatsapp API
    • Send Text
      POST
    • Send Template
      POST
  • Contact
    • Set Property Value on Contact
      PUT
    • Search Contacts [Complex]
      POST
    • Delete Property Value on Contact
      DELETE
    • Create Contact
      POST
    • Update Contact
      PUT
    • Get Contacts
      GET
    • Get Contact By Id
      GET
    • Delete Contact
      DELETE
    • Create Bulk Contacts vCards
      POST
    • Create Contact
      POST
    • Get Contacts Search
      POST
    • Contacts History
      GET
  • Contact Properties
    • List Contact Properties
      GET
    • Delete Contact Property
      DELETE
    • Update Contact Property
      PUT
    • Create Contact Property
      POST
    • Contact Properties Statistics
      GET
  • Support API
    • Upload Audio File
  • Outbound IVR API
    • Create Outbound IVR
  • Workspace API
    • Get Workspace Users
  • Conversations API
    • Get Conversation Timeline
    • List Conversations
    • Create Conversation
    • Assign Conversation
    • Get Conversation
  • Tags API
    • Create Tag
      POST
    • Delete Tag
      DELETE
    • Update Tag
      PUT
    • List Tags
      GET
  • Call Webhook
  • WhatsApp Message Webhook
  • Schemas
    • Call Webhook
    • WhatsApp Message Webhook
    • ConversationDto
    • CreateTagDto
    • ChannelConversationDto
    • UpdateTagDto
    • TagDto
    • ConversationTimelineDto
    • PagedResultOfTagDto
    • AiSummaryDto
    • ReplyInfoDto
    • InternalThreadDto
    • LocationMessageDto
    • AssignationInfoDto
    • PagedResultOfConversationDto
    • PagedResultOfConversationTimelineDto
  1. Tags API

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
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Tag created successfully
Bodyapplication/json

🟠401
🟠403
Request 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 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
Previous
Get Conversation
Next
Delete Tag
Built with