POST
/
api
/
v1
/
tags
Create Tag
curl --request POST \
  --url https://app.journeybee.io/api/v1/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "label": "<string>",
  "association": "<string>",
  "background_color": "<string>",
  "text_color": "<string>",
  "partner_type": "<string>"
}'
{
  "id": 123,
  "uuid": "<string>"
}

​
Authentication

curl -X POST "https://app.journeybee.io/api/v1/tags" \
  -H "Authorization: Bearer your-api-key-uuid" \
  -H "Content-Type: application/json" \
  -d '{"label": "VIP Client", "association": "lead", "background_color": "#10B981", "text_color": "#FFFFFF"}'

​
Request Body Schema

​
label
string
required
Tag label/name
​
association
string
required
What this tag applies to. Options: lead, lead_deal, partner, card
​
background_color
string
Background color (hex format, default: #6B7280)
​
text_color
string
Text color (hex format, default: #FFFFFF)
​
partner_type
string
Partner type association. Options: referral, reseller

​
Response Schema

​
id
number
The created tag ID
​
uuid
string
The created tag UUID

​
Notes

  • Requires API key with write_access permission
  • Colors must be valid hex color codes
  • Tags help with visual organization and filtering