Create a new Tag

Create a new custom tag and assign it to specified resources if resource_ids and resource_type are provided.

For resource_type 1 (ACCOUNT), only email addresses are accepted. For resource_type 2 (CAMPAIGN), only UUIDs are accepted. Please ensure your input matches the corresponding format based on the resource_type specified.

Heads up! if you are still unsure about what resource_type to use, you should check this guide first

Query Parameters

api_keystring Required

Your API Key

Body Parameters

labelstring Required

Specifies the label or name of the tag

descriptionstring

Provides a description or additional information about the tag

Response

200
Object
Successfully created the tag.

Response Attributes

idstring Required

The unique tag ID

timestamp_createdstring Required

The timestamp when the tag was created

timestamp_updatedstring Required

The timestamp of the last update of this tag

organization_idstring Required

The workspace id

labelstring Required

Tag label

descriptionstring

Tag description

400
Object
Bad Request

Response Attributes

statusCodenumber

The status code of the request

errorstring

The type of error

messagestring

Error message

500
Object
Internal server error

Response Attributes

statusCodenumber
errorstring
messagestring
Was this section helpful?

What made this section unhelpful for you?

Language Box

POST

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?