POST /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

OpenAPI Spec

Servers

Request headers

Name Type Required Description
revision String Yes

API endpoint revision (format: YYYY-MM-DD[.suffix])

Default value: "2026-04-15"

Query parameters

Name Type Required Description
fields[tag-group][] Array No

For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.