Klaviyo API
OpenAPI 3.1 definition for Klaviyo profiles, lists, campaigns, and events using the current JSON:API endpoints.
Connect this API to an AI agent Browse all specs
What you can do with Klaviyo API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /api/profiles/ |
getApiProfiles | List profiles Method: GET Path: /api/profiles/ IMPORTANT: This function has 1 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - page[cursor]: page[cursor] parameter. - filter: filter parameter. - sort: sort parameter. Header Parameters: REQUIRED: - revision: Klaviyo API revision date/version. |
| GET | /api/profiles/{id}/ |
getApiProfilesById | Get a profile Method: GET Path: /api/profiles/{id}/ IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - id: id parameter. Header Parameters: REQUIRED: - revision: revision parameter. |
| GET | /api/lists/ |
getApiLists | List lists Method: GET Path: /api/lists/ IMPORTANT: This function has 1 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - page[cursor]: page[cursor] parameter. Header Parameters: REQUIRED: - revision: revision parameter. |
| GET | /api/lists/{id}/ |
getApiListsById | Get a list Method: GET Path: /api/lists/{id}/ IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - id: id parameter. Header Parameters: REQUIRED: - revision: revision parameter. |
| GET | /api/lists/{id}/profiles/ |
getApiListsByIdProfiles | List profiles in a list Method: GET Path: /api/lists/{id}/profiles/ IMPORTANT: This function has 2 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - id: id parameter. Query Parameters: OPTIONAL: - page[cursor]: page[cursor] parameter. Header Parameters: REQUIRED: - revision: revision parameter. |
| GET | /api/campaigns/ |
getApiCampaigns | List campaigns Method: GET Path: /api/campaigns/ IMPORTANT: This function has 1 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - page[cursor]: page[cursor] parameter. - filter: filter parameter. Header Parameters: REQUIRED: - revision: revision parameter. |
| GET | /api/campaigns/{id}/ |
getApiCampaignsById | Get a campaign Method: GET Path: /api/campaigns/{id}/ IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - id: id parameter. Header Parameters: REQUIRED: - revision: revision parameter. |
| POST | /api/events/ |
postApiEvents | Create an event Method: POST Path: /api/events/ IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Header Parameters: REQUIRED: - revision: revision parameter. Request Body: REQUIRED: - body: Request body (application/json) |
Usage guide
## Klaviyo API This listing describes documented production API routes only. Before making requests, read the provider's official documentation and configure the server URL variables where applicable. ### Authentication Create a private API key in the Klaviyo account settings. Send it exactly as `Authorization: Klaviyo-API-Key YOUR_PRIVATE_API_KEY`; do not change it to `Bearer`. Include the required `revision` header shown in the official reference. Use OAuth for multi-account technology-partner integrations. ### Operational guidance Use pagination for collection endpoints, respect provider rate limits, validate identifiers before mutating resources, and follow each provider's terms, consent requirements, and data-retention policies.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Klaviyo API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.