API reference
Tags API
Labels for campaigns, flows, lists and segments, and the groups they belong to.
Endpoints
- GETList tag groups/api/tag-groups
- POSTCreate a tag group/api/tag-groups
- GETList tags/api/tags
- POSTCreate a tag/api/tags
- GETGet a tag group/api/tag-groups/{id}
- PATCHRename a tag group/api/tag-groups/{id}
- DELDelete a tag group/api/tag-groups/{id}
- GETGet a tag/api/tags/{id}
- PATCHRename a tag/api/tags/{id}
- DELDelete a tag/api/tags/{id}
- GETList the tags in a tag group/api/tag-groups/{id}/tags
- GETGet the tag group of a tag/api/tags/{id}/tag-group
- GETList the ids of the tags in a tag group/api/tag-groups/{id}/relationships/tags
- GETList the ids of campaigns with a tag/api/tags/{id}/relationships/campaigns
- POSTPut a tag on campaigns/api/tags/{id}/relationships/campaigns
- DELTake a tag off campaigns/api/tags/{id}/relationships/campaigns
- GETList the ids of flows with a tag/api/tags/{id}/relationships/flows
- POSTPut a tag on flows/api/tags/{id}/relationships/flows
- DELTake a tag off flows/api/tags/{id}/relationships/flows
- GETList the ids of lists with a tag/api/tags/{id}/relationships/lists
- POSTPut a tag on lists/api/tags/{id}/relationships/lists
- DELTake a tag off lists/api/tags/{id}/relationships/lists
- GETList the ids of segments with a tag/api/tags/{id}/relationships/segments
- POSTPut a tag on segments/api/tags/{id}/relationships/segments
- DELTake a tag off segments/api/tags/{id}/relationships/segments
- GETGet the id of a tag's tag group/api/tags/{id}/relationships/tag-group
Access
A private key with these scopes reaches every endpoint here. Each endpoint page lists the scopes it needs.
campaigns:readcampaigns:writeflows:readflows:writelists:readlists:writesegments:readsegments:writetags:readtags:writeCoverage
26 of the 26 operations in this area of Klaviyo's API are built here.
Complete
Every operation in this area of Klaviyo's API is built.