Klaviyo
Klaviyo support focuses on profiles and campaign reads. Vorlek hides API revision details and normalizes Klaviyo's status vocabulary for agents.
Connection setup
- Create a Klaviyo private API key starting with
pk_. - Grant scopes for profiles, campaigns, and templates according to the tools you plan to call.
- Connect with
vorlek connect klaviyo --api-key pk_xxxxxor through the dashboard. - Run
get_connection_statusbefore relying on the connection in an agent workflow.
Gotchas
- Vorlek pins Klaviyo API revision
2026-04-15for launch behavior. - Klaviyo accepts arbitrary profile properties, so
fields_auto_createdis always empty even when new properties land. - Klaviyo campaign statuses are Title Case natively. Vorlek accepts and returns lowercase
draft,scheduled,sent, andall. - Transactional email is flow-triggered and asynchronous, so
send_transactionalreturnsTOOL_NOT_SUPPORTED.
Tool coverage
| Tool | Support | Notes |
|---|---|---|
upsert_contact | Yes | Writes profile fields directly; no custom-field creation step is required. |
get_contact | Yes | Looks up one profile by email for read-after-write verification. |
send_transactional | No | Returns TOOL_NOT_SUPPORTED; use Klaviyo flows for transactional behavior. |
get_campaign_stats | Yes | Normalizes campaign metrics where Klaviyo exposes them. |
list_templates | Yes | Returns available template ids and names. |
list_campaigns | Yes | Maps Klaviyo Title Case statuses into Vorlek lowercase statuses. |