Create Tag Group
POST {{baseUrl}}/api/tag-groups/
Create a tag group. An account cannot have more than 50 unique tag groups.
If exclusive
is not specified true
or false
, the tag group defaults to non-exclusive.
If a tag group is non-exclusive, any given related resource (campaign, flow, etc.) can be linked to multiple tags from that tag group. If a tag group is exclusive, any given related resource can only be linked to one tag from that tag group.
Rate limits:
Burst: 3/s
Steady: 60/m
Scopes:
tags:read
tags:write
Request Body
{"data"=>{"type"=>"tag-group", "attributes"=>{"name"=>"<string>", "exclusive"=>"<boolean>"}}}
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-group","id":"\u003cstring\u003e","attributes":{"name":"\u003cstring\u003e","exclusive":"\u003cboolean\u003e","default":"\u003cboolean\u003e"},"links":{"self":"\u003curi\u003e"},"relationships":{"tags":{"data":[{"type":"tag","id":"\u003cstring\u003e"},{"type":"tag","id":"\u003cstring\u003e"}],"links":{"self":"\u003curi\u003e","related":"\u003curi\u003e"}}}}}