Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Klaviyo Tags API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Tags. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.

This API exposes 26 operations across 12 paths, and defines 36 schemas. It is described by OpenAPI 3.0.2, at version 2026-04-15.

Requests are made against a single base URL, https://a.klaviyo.com.

26 operations 12 paths 36 schemas 6 DELETE12 GET2 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
2026-04-15
Base URL
https://a.klaviyo.com
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Klaviyo Tags API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Klaviyo-API-Key). By default, every request must be authenticated.

  • Klaviyo-API-Key — Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…

Paths & Operations 26

Across 12 paths, the API surfaces 26 operations — 6 DELETE, 12 GET, 2 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Tags 26

tags

GET
/api/tags
Get Tags
get_tags 8 params → 2004XX5XX
POST
/api/tags
Create Tag
create_tag 1 param body → 2014XX5XX
GET
/api/tags/{id}
Get Tag
get_tag 5 params → 2004XX5XX
PATCH
/api/tags/{id}
Update Tag
update_tag 2 params body → 2044XX5XX
DELETE
/api/tags/{id}
Delete Tag
delete_tag 2 params → 2044XX5XX
GET
/api/tag-groups
Get Tag Groups
get_tag_groups 6 params → 2004XX5XX
POST
/api/tag-groups
Create Tag Group
create_tag_group 1 param body → 2014XX5XX
GET
/api/tag-groups/{id}
Get Tag Group
get_tag_group 3 params → 2004XX5XX
PATCH
/api/tag-groups/{id}
Update Tag Group
update_tag_group 2 params body → 2044XX5XX
DELETE
/api/tag-groups/{id}
Delete Tag Group
delete_tag_group 2 params → 2044XX5XX
GET
/api/tags/{id}/relationships/flows
Get Flow IDs for Tag
get_flow_ids_for_tag 2 params → 2004XX5XX
POST
/api/tags/{id}/relationships/flows
Tag Flows
tag_flows 2 params body → 2044XX5XX
DELETE
/api/tags/{id}/relationships/flows
Remove Tag from Flows
remove_tag_from_flows 2 params body → 2044XX5XX
GET
/api/tags/{id}/relationships/campaigns
Get Campaign IDs for Tag
get_campaign_ids_for_tag 2 params → 2004XX5XX
POST
/api/tags/{id}/relationships/campaigns
Tag Campaigns
tag_campaigns 2 params body → 2044XX5XX
DELETE
/api/tags/{id}/relationships/campaigns
Remove Tag from Campaigns
remove_tag_from_campaigns 2 params body → 2044XX5XX
GET
/api/tags/{id}/relationships/lists
Get List IDs for Tag
get_list_ids_for_tag 2 params → 2004XX5XX
POST
/api/tags/{id}/relationships/lists
Tag Lists
tag_lists 2 params body → 2044XX5XX
DELETE
/api/tags/{id}/relationships/lists
Remove Tag from Lists
remove_tag_from_lists 2 params body → 2044XX5XX
GET
/api/tags/{id}/relationships/segments
Get Segment IDs for Tag
get_segment_ids_for_tag 2 params → 2004XX5XX
POST
/api/tags/{id}/relationships/segments
Tag Segments
tag_segments 2 params body → 2044XX5XX
DELETE
/api/tags/{id}/relationships/segments
Remove Tag from Segments
remove_tag_from_segments 2 params body → 2044XX5XX
GET
/api/tags/{id}/tag-group
Get Tag Group for Tag
get_tag_group_for_tag 3 params → 2004XX5XX
GET
/api/tags/{id}/relationships/tag-group
Get Tag Group ID for Tag
get_tag_group_id_for_tag 2 params → 2004XX5XX
GET
/api/tag-groups/{id}/tags
Get Tags for Tag Group
get_tags_for_tag_group 3 params → 2004XX5XX
GET
/api/tag-groups/{id}/relationships/tags
Get Tag IDs for Tag Group
get_tag_ids_for_tag_group 2 params → 2004XX5XX

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are TagGroupResponseObjectResource (5 properties), CollectionLinks (5 properties), TagResponseObjectResource (5 properties), GetTagResponseCompoundDocument (3 properties). Each schema is shown below with its type and property counts.

GetTagResponseCompoundDocument
object
3 properties 1 required
GetTagFlowRelationshipsResponseCollection
object
2 properties 1 required
PostTagGroupResponse
object
2 properties 1 required
GetTagResponseCollection
object
2 properties 1 required
ListEnum
string
TagCampaignOp
object
1 property 1 required
PostTagResponse
object
2 properties 1 required
TagFlowOp
object
1 property 1 required
TagGroupCreateQuery
object
1 property 1 required
TagUpdateQuery
object
1 property 1 required
TagGroupUpdateQueryResourceObject
object
3 properties 3 required
TagCreateQuery
object
1 property 1 required
TagListOp
object
1 property 1 required
GetTagGroupRelationshipResponse
object
2 properties 1 required
TagCreateQueryResourceObject
object
3 properties 2 required
TagResponseObjectResource
object
5 properties 4 required
TagGroupUpdateQuery
object
1 property 1 required
GetTagGroupTagsRelationshipsResponseCollection
object
2 properties 1 required
FlowEnum
string
CampaignEnum
string
GetTagListRelationshipsResponseCollection
object
2 properties 1 required
GetTagGroupResponseCollection
object
2 properties 1 required
GetTagSegmentRelationshipsResponseCollection
object
2 properties 1 required
SegmentEnum
string
TagGroupResponseObjectResource
object
5 properties 4 required
GetTagResponseCollectionCompoundDocument
object
3 properties 1 required
GetTagGroupResponse
object
2 properties 1 required
ObjectLinks
object
1 property 1 required
TagUpdateQueryResourceObject
object
3 properties 3 required
TagGroupEnum
string
CollectionLinks
object
5 properties 1 required
TagGroupCreateQueryResourceObject
object
2 properties 2 required
TagSegmentOp
object
1 property 1 required
TagEnum
string
GetTagCampaignRelationshipsResponseCollection
object
2 properties 1 required
RelationshipLinks
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-tags-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

Klaviyo Accounts API
Klaviyo Campaigns API
Klaviyo Catalogs API
Klaviyo Client API
Klaviyo Conversations API
Klaviyo Coupons API
Klaviyo Custom Objects API
Klaviyo Data Privacy API
Klaviyo Events API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API