Skip to main content
Tags help you label and segment contacts for use in broadcasts, sequences, and automation flows. Use this endpoint to create a new tag in your workspace. Each tag name must be unique within the workspace. You can optionally place the tag into a folder to keep your tag library organised.
POST /api/v1/tags

Request Body

string
required
A unique name for the tag. Must be between 1 and 255 characters.
string | null
The ID of the folder to place this tag in. Pass null or omit to leave the tag unorganised.

Code Examples

Response

Returns 201 Created with the newly created tag object.

Response Fields

string
required
The unique identifier for the created tag.
string
required
The name of the newly created tag.

Example Response