Skip to main content
PUT
cURL
Create a workspace conversation tag. Body is { "title", "color" }. The server assigns id and associatedTo. Duplicate title in the same workspace returns 400. Copy the returned object into updateConversation.selectedTags — do not invent tag ids. Prefer GET tags and reuse an existing tag when one already matches.

Authorizations

Personal access token from Pingmee Settings → Developer Tools

x-api-key
string
header
required

Business API key from Pingmee Settings → Developer Tools

Body

application/json

Tag title and color

title
string
required

Human-readable tag title

color
string
required

Tag color (hex, rgb, or named color)

Response

Conversation tag created

id
string
required

Unique identifier of the tag

title
string
required

Human-readable tag title

color
string
required

Tag color (hex, rgb, or named color)

associatedTo
string
required

Business or account the tag is associated with

Last modified on September 4, 2026