Create a New Tag

POST

https://api.plusvibe.ai/api/v1/tags/create

Creates a new tag in the specified workspace. Tags are used to organize and categorize email accounts and campaigns.

Required Fields:

name: Display name for the tag (1-100 characters)

color: Hex color code for visual identification (#FF5733 or #F57)

description: Optional description of the tag's purpose
Note: Tag names are case-insensitive and must be unique within the workspace.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Tag created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Create VIP Clients tagCreate campaign tagCreate simple tag

curl --location --request POST 'https://api.plusvibe.ai/api/v1/tags/create' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workspace_id": "507f1f77bcf86cd799439011",
    "name": "PlusVibe DFY",
    "color": "#FF5733",
    "description": "Best setup for deliverability"
}'

Response Example

200 - Successful tag creation

{
    "status": "success",
    "tag_id": "68c2ad7ea8b1ea94b4b08818"
}

Modified at 2025-09-11 11:16:01

List Tags

Update an Existing Tag