Skip to main content
POST
Create a new tag on your account.

Authorizations

Authorization
string
header
required

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

Body

application/json

The properties to be assigned to the tag.

label
string
required

The text to describe the new tag.

Example:

"Team"

color
enum<string>
required

The color assigned for visual purposes when displaying the tags.

Available options:
emerald,
red,
yellow,
orange,
blue,
indigo,
purple,
pink,
zinc

Response

Success

Standard response object for successful single-resource requests in the Profile Behavior API. Contains an HTTP status code, the returned resource data, and a status indicator.

code
integer<int32>
required

HTTP status code of the successful response.

status
enum<string>

Always "success" for successful responses.

Available options:
success
tag
object

Represents a tag used for organizing profiles, teams, or groups within an account. Tags allow for flexible grouping, filtering, and analytics across individuals and teams.