Skip to main content
POST
/
workspaces
/
{workspace}
/
tags
Create Tag
curl --request POST \
  --url https://lancepilot.com/api/v3/workspaces/{workspace}/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "VIP"
}'
{
  "status": 201,
  "message": "Resource created successfully.",
  "data": {}
}

JSON Request Example

{
  "name": "VIP"
}

📝 Field Requirements

FieldTypeRequiredNotes
namestring (max 255)YesTag name (must be unique within the workspace).

💡 Notes

  • Tag names must be unique within each workspace
  • Tags can be used to organize and categorize contacts
  • Unlike labels, tags do not have a color property

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace
string<uuid>
required

ID of the workspace.

Body

application/json

Tag creation parameters.

name
string
required

Unique name per workspace.

Maximum string length: 255

Response

status
integer
required
Example:

201

message
string
required
Example:

"Resource created successfully."

data
object
required

Created resource data.