GET /api/tag-groups

List all tag groups in an account. Every account has one default tag group.

Tag groups can be filtered by name, exclusive, and default, and sorted by name or id in ascending or descending order.

Returns a maximum of 25 tag groups per request, which can be paginated with cursor-based pagination.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes: tags:read

Servers

Request headers

Name Type Required Description
revision String Yes

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

Default value: "2025-04-15"

Query parameters

Name Type Required Description
fieldstag-group[] Array No

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

filter String No

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
name: contains, ends-with, equals, starts-with
exclusive: equals
default: equals

sort String No

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

Possible values:

  • "id"
  • "name"
  • "-name"
  • "-id"
pagecursor String No

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

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.