Klaviyo

Klaviyo Flows API

flows

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 20

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/flows List automated flows · Get Flows #
Ask an LLM
“What automated flows do I have in Klaviyo?”
“Can I list only my live flows?”
Tell an agent
List flows matching {filter}.
Show all flows sorted by {sort}.
POST /api/flows Create a flow from a definition · Create Flow #
Ask an LLM
“How do I build a new automated flow through the API?”
“Can I create a flow with its actions from an encoded definition?”
Tell an agent
Create a flow from definition {definition}.
Build a new automation flow using {definition}.
GET /api/flows/{id} Get one flow · Get Flow #
Ask an LLM
“What are the details and status of a specific flow?”
“Can I fetch a flow's full definition?”
Tell an agent
Get flow {flow_id}.
Show the definition and status of flow {flow_id}.
PATCH /api/flows/{id} Change a flow's status · Update Flow Status #
Ask an LLM
“How do I turn a flow live or put it back in draft?”
“Does changing a flow's status also change its actions?”
Tell an agent
Set the status of flow {flow_id} to {status}.
Change the status of flow {flow_id} and all its actions to {status}.
DELETE /api/flows/{id} Delete a flow · Delete Flow #
Ask an LLM
“Can I permanently delete an automated flow?”
“What's the way to remove a flow I no longer need?”
Tell an agent destructive · confirm first
Delete flow {flow_id}.
Permanently remove flow {flow_id}.
GET /api/flow-actions/{id} Get one flow action · Get Flow Action #
Ask an LLM
“What does a specific step in my flow do?”
“Can I look up a single flow action by ID?”
Tell an agent
Get flow action {action_id}.
Show the settings of flow step {action_id}.
PATCH /api/flow-actions/{id} Update a flow action · Update Flow Action #
Ask an LLM
“Can I change the settings of one step in a flow?”
“How do I edit a single flow action?”
Tell an agent
Update flow action {action_id} with {changes}.
Change flow step {action_id} to {changes}.
GET /api/flow-messages/{id} Get one flow message · Get Flow Message #
Ask an LLM
“What's in a specific email or SMS message within a flow?”
“Can I fetch a flow message by its ID?”
Tell an agent
Get flow message {message_id}.
Show the content of flow message {message_id}.
GET /api/flows/{id}/flow-actions List the actions in a flow · Get Actions for Flow #
Ask an LLM
“What steps make up a particular flow?”
“Can I see full details of every action in one flow?”
Tell an agent
List the actions in flow {flow_id}.
Show every step of flow {flow_id} with its details.
GET /api/flows/{id}/relationships/flow-actions List action IDs for a flow · Get Action IDs for Flow #
Ask an LLM
“Can I get only the action IDs for one flow?”
“Which action IDs belong to a flow?”
Tell an agent
Get only the action IDs in flow {flow_id}.
Return the action ID list for flow {flow_id}.
GET /api/flows/{id}/tags List the tags on a flow · Get Tags for Flow #
Ask an LLM
“What tags are applied to a specific flow?”
“Can I see the tag names on one flow?”
Tell an agent
List the tags on flow {flow_id}.
Show tag names applied to flow {flow_id}.
GET /api/flows/{id}/relationships/tags List tag IDs on a flow · Get Tag IDs for Flow #
Ask an LLM
“Can I get just the tag IDs attached to a flow?”
“Which tag IDs does one flow carry?”
Tell an agent
Get only the tag IDs on flow {flow_id}.
Return the tag ID list for flow {flow_id}.
GET /api/flow-actions/{id}/flow Get the flow a flow action belongs to · Get Flow for Flow Action #
Ask an LLM
“Which flow does a given action belong to?”
“Can I get the full parent flow from an action ID?”
Tell an agent
Get the flow that contains action {action_id}.
Show the parent flow details for step {action_id}.
GET /api/flow-actions/{id}/relationships/flow Get the flow ID for a flow action · Get Flow ID for Flow Action #
Ask an LLM
“Can I get only the parent flow ID for an action?”
“What's the flow ID behind a given step?”
Tell an agent
Get only the flow ID for action {action_id}.
Return the parent flow ID of step {action_id}.
GET /api/flow-actions/{id}/flow-messages List the messages in a flow action · Get Messages For Flow Action #
Ask an LLM
“What messages does a particular flow step send?”
“Can I see full message details for one flow action?”
Tell an agent
List the messages for flow action {action_id}.
Show every message sent by step {action_id}.
GET /api/flow-actions/{id}/relationships/flow-messages List message IDs for a flow action · Get Message IDs for Flow Action #
Ask an LLM
“Can I get only the message IDs for a flow action?”
“Which message IDs belong to one flow step?”
Tell an agent
Get only the message IDs for flow action {action_id}.
Return the message ID list for step {action_id}.
GET /api/flow-messages/{id}/flow-action Get the flow action behind a message · Get Action for Flow Message #
Ask an LLM
“Which flow step sends a particular message?”
“Can I get full action details from a message ID?”
Tell an agent
Get the flow action for message {message_id}.
Show the step that sends flow message {message_id}.
GET /api/flow-messages/{id}/relationships/flow-action Get the flow action ID for a message · Get Action ID for Flow Message #
Ask an LLM
“Can I get just the action ID for a flow message?”
“What's the action ID behind one message?”
Tell an agent
Look up just the step ID behind flow message {message_id}.
Return the action identifier that owns message {message_id}.
GET /api/flow-messages/{id}/template Get the template used by a flow message · Get Template for Flow Message #
Ask an LLM
“Which email template does a flow message use?”
“Can I see the full template content behind a flow message?”
Tell an agent
Get the template for flow message {message_id}.
Show the template content used by message {message_id}.
GET /api/flow-messages/{id}/relationships/template Get the template ID for a flow message · Get Template ID for Flow Message #
Ask an LLM
“Can I get only the template ID for a flow message?”
“What's the template ID attached to a message in my flow?”
Tell an agent
Get only the template ID for flow message {message_id}.
Return the template ID behind message {message_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-flows-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-flows-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-flows-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-flows-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Klaviyo Flows 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 (302 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/openapi/klaviyo-flows-api-openapi.yml