Skip to main content
POST
/
tag
Create a new tag on your account.
curl --request POST \
  --url https://vanguard.profilebehavior.com/api/v4/tag \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Team",
  "color": "emerald"
}
'
{
  "code": 200,
  "tag": {
    "label": "Team",
    "color": "emerald",
    "profiles": [
      "6592008029c8c3e4dc76256c",
      "507f191e810c19729de860ea"
    ]
  },
  "status": "success"
}

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

Base schema that provides unique identification and timestamp metadata for resources in the Profile Behavior API.

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.