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
OpenAPI Spec
Servers
- https://a.klaviyo.com
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 |
|---|---|---|---|
page[cursor] |
String | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination |
filter |
String | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering |
sort |
String | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting Valid values:
|
fields[tag-group][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets |
page[size] |
Integer | No |
Default: 25. Min: 1. Max: 25. Default value: 25 |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.