Klaviyo

Klaviyo Tags API

tags

GitHub OpenAPI

Operations 26

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/tags List tags in the account · Get Tags #
Ask an LLM
“What tags have we created in Klaviyo?”
“Can I find tags whose name contains a word?”
Tell an agent
List tags matching {filter}.
Show all tags sorted by {sort}.
POST /api/tags Create a tag · Create Tag #
Ask an LLM
“How do I create a new tag for organizing campaigns and flows?”
“Is there a limit on how many tags an account can have?”
Tell an agent
Create a tag {tag}.
Add a new tag inside a chosen tag group: {tag}.
GET /api/tags/{id} Get one tag · Get Tag #
Ask an LLM
“What are the details of a specific tag?”
“Can I see which tag group a tag belongs to when I fetch it?”
Tell an agent
Get tag {tag_id}.
Show tag {tag_id} along with its tag group.
PATCH /api/tags/{id} Rename a tag · Update Tag #
Ask an LLM
“Can I rename an existing tag?”
“Is it possible to move a tag into a different tag group?”
Tell an agent
Rename tag {tag_id} using {changes}.
Change the name of tag {tag_id} to {changes}.
DELETE /api/tags/{id} Delete a tag · Delete Tag #
Ask an LLM
“Can I delete a tag I no longer use?”
“What happens to campaigns and flows when a tag is deleted?”
Tell an agent destructive · confirm first
Delete tag {tag_id}.
Remove tag {tag_id} and all its associations.
GET /api/tag-groups List tag groups · Get Tag Groups #
Ask an LLM
“What tag groups exist in my account?”
“Which of my tag groups are exclusive?”
Tell an agent
List tag groups matching {filter}.
Show every tag group, including the default one.
POST /api/tag-groups Create a tag group · Create Tag Group #
Ask an LLM
“How do I create an exclusive tag group?”
“What's the maximum number of tag groups an account can have?”
Tell an agent
Create a tag group {group}.
Add a new exclusive tag group: {group}.
GET /api/tag-groups/{id} Get one tag group · Get Tag Group #
Ask an LLM
“What are the settings of a particular tag group?”
“Can I check whether a tag group is exclusive or the default?”
Tell an agent
Get tag group {group_id}.
Show whether tag group {group_id} is exclusive.
PATCH /api/tag-groups/{id} Rename a tag group · Update Tag Group #
Ask an LLM
“Can I rename a tag group?”
“Is it possible to make an existing tag group exclusive later?”
Tell an agent
Rename tag group {group_id} using {changes}.
Give tag group {group_id} a new group name: {changes}.
DELETE /api/tag-groups/{id} Delete a tag group and its tags · Delete Tag Group #
Ask an LLM
“What happens to the tags inside a tag group when I delete it?”
“Can the default tag group be deleted?”
Tell an agent destructive · confirm first
Delete tag group {group_id}.
Remove tag group {group_id} along with all tags in it.
GET /api/tags/{id}/relationships/flows List flows carrying a tag · Get Flow IDs for Tag #
Ask an LLM
“Which flows are tagged with a particular tag?”
“Can I get the flow IDs associated with one tag?”
Tell an agent
List the flow IDs tagged with {tag_id}.
Show which flows carry tag {tag_id}.
POST /api/tags/{id}/relationships/flows Apply a tag to flows · Tag Flows #
Ask an LLM
“How do I tag several flows at once?”
“How many tags can a single flow have?”
Tell an agent
Apply tag {tag_id} to flows {flows}.
Tag flows {flows} with {tag_id}.
DELETE /api/tags/{id}/relationships/flows Remove a tag from flows · Remove Tag from Flows #
Ask an LLM
“Can I untag some flows without deleting the tag?”
“How do I take a tag off several flows?”
Tell an agent destructive · confirm first
Remove tag {tag_id} from flows {flows}.
Untag flows {flows} from {tag_id}.
GET /api/tags/{id}/relationships/campaigns List campaigns carrying a tag · Get Campaign IDs for Tag #
Ask an LLM
“Which campaigns are tagged with a specific tag?”
“Can I get campaign IDs for one tag?”
Tell an agent
List the campaign IDs tagged with {tag_id}.
Show which campaigns carry tag {tag_id}.
POST /api/tags/{id}/relationships/campaigns Apply a tag to campaigns · Tag Campaigns #
Ask an LLM
“How do I tag a batch of campaigns?”
“Is there a cap on how many tags a campaign can hold?”
Tell an agent
Apply tag {tag_id} to campaigns {campaigns}.
Tag campaigns {campaigns} with {tag_id}.
DELETE /api/tags/{id}/relationships/campaigns Remove a tag from campaigns · Remove Tag from Campaigns #
Ask an LLM
“Can I untag campaigns without deleting the tag itself?”
“What's the way to strip a tag off several campaigns?”
Tell an agent destructive · confirm first
Remove tag {tag_id} from campaigns {campaigns}.
Untag campaigns {campaigns} from {tag_id}.
GET /api/tags/{id}/relationships/lists List lists carrying a tag · Get List IDs for Tag #
Ask an LLM
“Which subscriber lists have a particular tag?”
“Can I get list IDs associated with one tag?”
Tell an agent
List the list IDs tagged with {tag_id}.
Show which lists carry tag {tag_id}.
POST /api/tags/{id}/relationships/lists Apply a tag to lists · Tag Lists #
Ask an LLM
“How do I tag several subscriber lists at once?”
“How many tags can one list be associated with?”
Tell an agent
Apply tag {tag_id} to lists {lists}.
Tag lists {lists} with {tag_id}.
DELETE /api/tags/{id}/relationships/lists Remove a tag from lists · Remove Tag from Lists #
Ask an LLM
“Can I untag some lists but keep the tag?”
“What's the way to take a tag off several lists?”
Tell an agent destructive · confirm first
Remove tag {tag_id} from lists {lists}.
Untag lists {lists} from {tag_id}.
GET /api/tags/{id}/relationships/segments List segments carrying a tag · Get Segment IDs for Tag #
Ask an LLM
“Which segments are tagged with a given tag?”
“Can I get segment IDs for one tag?”
Tell an agent
List the segment IDs tagged with {tag_id}.
Show which segments carry tag {tag_id}.
POST /api/tags/{id}/relationships/segments Apply a tag to segments · Tag Segments #
Ask an LLM
“Can I tag several segments in one call?”
“Is there a limit to how many tags a segment can have?”
Tell an agent
Apply tag {tag_id} to segments {segments}.
Tag segments {segments} with {tag_id}.
DELETE /api/tags/{id}/relationships/segments Remove a tag from segments · Remove Tag from Segments #
Ask an LLM
“Can I untag segments without deleting the tag?”
“What's the way to strip a tag off multiple segments?”
Tell an agent destructive · confirm first
Remove tag {tag_id} from segments {segments}.
Untag segments {segments} from {tag_id}.
GET /api/tags/{id}/tag-group Get the tag group a tag belongs to · Get Tag Group for Tag #
Ask an LLM
“Which tag group does a particular tag sit in?”
“Can I see the full tag group details for a tag?”
Tell an agent
Get the tag group for tag {tag_id}.
Show the group details that tag {tag_id} belongs to.
GET /api/tags/{id}/relationships/tag-group Get the tag group ID for a tag · Get Tag Group ID for Tag #
Ask an LLM
“Can I get just the tag group ID for one tag?”
“What's the group ID of a given tag?”
Tell an agent
Get only the tag group ID for tag {tag_id}.
Return the group ID that tag {tag_id} is in.
GET /api/tag-groups/{id}/tags List the tags in a tag group · Get Tags for Tag Group #
Ask an LLM
“What tags are inside a particular tag group?”
“Can I see full tag details for one group?”
Tell an agent
List the tags in tag group {group_id}.
Show tag names and details within group {group_id}.
GET /api/tag-groups/{id}/relationships/tags List tag IDs in a tag group · Get Tag IDs for Tag Group #
Ask an LLM
“Can I get only the tag IDs in a tag group?”
“Which tag IDs belong to one group?”
Tell an agent
Get only the tag IDs in tag group {group_id}.
Return the tag ID list for group {group_id}.

Documentation

📖
Documentation
https://developers.klaviyo.com/
📖
Authentication
https://developers.klaviyo.com/en/docs/authenticate_
📖
RateLimits
https://developers.klaviyo.com/en/docs/rate_limits_and_error_handling

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/openapi/klaviyo-tags-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/asyncapi/klaviyo-webhooks-asyncapi.yaml

Other Resources

🔗
Reference
https://developers.klaviyo.com/en/reference/api_overview
🔗
Versioning
https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy
🔗
ChangeLog
https://developers.klaviyo.com/en/docs/changelog_
🔗
SDKs
https://developers.klaviyo.com/en/docs/sdk_overview
🔗
GitHub
https://github.com/klaviyo/openapi
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/overlays/klaviyo-tags-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/klaviyo:klaviyo-tags-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

klaviyo-tags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Klaviyo Tags API
  version: '2026-04-15'
  description: The Klaviyo REST API. Please visit https://developers.klaviyo.com for more details.
  contact:
    name: Klaviyo Developer Experience Team
    email: developers@klaviyo.com
    url: https://developers.klaviyo.com
  termsOfService: https://www.klaviyo.com/legal/api-terms
  license:
    name: License
    url: https://www.klaviyo.com/legal
servers:
- url: https://a.klaviyo.com
  description: Production
security:
- Klaviyo-API-Key: []
tags:


# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/openapi/klaviyo-tags-api-openapi.yml