How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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.2.0, 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.2.0
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), TagGroupUpdateQueryResourceObject (3 properties). Each schema is shown below with its type and property counts.

GetTagCampaignRelationshipsResponseCollection
object
2 properties 1 required
SegmentEnum
string
TagUpdateQueryResourceObject
object
3 properties 3 required
GetTagGroupTagsRelationshipsResponseCollection
object
2 properties 1 required
TagFlowOp
object
1 property 1 required
GetTagGroupResponseCollection
object
2 properties 1 required
TagResponseObjectResource
object
5 properties 4 required
FlowEnum
string
GetTagGroupResponse
object
2 properties 1 required
TagCreateQuery
object
1 property 1 required
GetTagFlowRelationshipsResponseCollection
object
2 properties 1 required
GetTagResponseCompoundDocument
object
3 properties 1 required
ListEnum
string
CampaignEnum
string
RelationshipLinks
object
2 properties 2 required
TagCampaignOp
object
1 property 1 required
TagGroupUpdateQueryResourceObject
object
3 properties 3 required
GetTagListRelationshipsResponseCollection
object
2 properties 1 required
PostTagGroupResponse
object
2 properties 1 required
TagListOp
object
1 property 1 required
CollectionLinks
object
5 properties 1 required
TagCreateQueryResourceObject
object
3 properties 2 required
TagGroupEnum
string
TagEnum
string
TagGroupResponseObjectResource
object
5 properties 4 required
GetTagGroupRelationshipResponse
object
2 properties 1 required
TagUpdateQuery
object
1 property 1 required
TagGroupCreateQuery
object
1 property 1 required
GetTagSegmentRelationshipsResponseCollection
object
2 properties 1 required
TagGroupCreateQueryResourceObject
object
2 properties 2 required
PostTagResponse
object
2 properties 1 required
GetTagResponseCollection
object
2 properties 1 required
TagGroupUpdateQuery
object
1 property 1 required
GetTagResponseCollectionCompoundDocument
object
3 properties 1 required
TagSegmentOp
object
1 property 1 required
ObjectLinks
object
1 property 1 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
Where this information came from

This is an independent, third-party profile of Klaviyo Tags API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.