Create Tag
POST {{baseUrl}}/api/tags/
Create a tag. An account cannot have more than 500 unique tags.
A tag belongs to a single tag group. If the tag_group_id is not specified, the tag is added to the account's default tag group.
Rate limits:
Burst: 3/s
Steady: 60/m
Scopes:
tags:read
tags:write
Request Body
{"data"=>{"type"=>"tag", "attributes"=>{"name"=>"<string>", "tag_group_id"=>"<string>"}}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
revision | string | (Required) API endpoint revision (format: YYYY-MM-DD[.suffix]) | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"data":{"type":"tag","id":"\u003cstring\u003e","attributes":{"name":"\u003cstring\u003e"},"links":{"self":"\u003curi\u003e"},"relationships":{"tag-group":{"data":[{"type":"tag-group","id":"\u003cstring\u003e"},{"type":"tag-group","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"lists":{"data":[{"type":"list","id":"\u003cstring\u003e"},{"type":"list","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"segments":{"data":[{"type":"segment","id":"\u003cstring\u003e"},{"type":"segment","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"campaigns":{"data":[{"type":"campaign","id":"\u003cstring\u003e"},{"type":"campaign","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}},"flows":{"data":[{"type":"flow","id":"\u003cstring\u003e"},{"type":"flow","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}}}}}