Klaviyo

Sync e-commerce customer profiles and trigger email/SMS flows via the Klaviyo API.

• Base URL: https://a.klaviyo.com/api
• Auth: Authorization: Klaviyo-API-Key <private-api-key> (no OAuth, single key)
• Revision header: every request sends a revision header (a date-stamped API version, e.g. 2024-10-15). The tool sends a stable default; override it with the revision input.

What it does

Klaviyo flows (automations) are triggered by events: when you post an event (a metric like Placed Order) for a profile, any flow whose trigger is that metric fires and delivers its configured email/SMS. This tool lets InTouch jobs upsert profiles, fire those triggering events, and inspect campaigns — all with the credential held in InTouch, never in the AI context.

Operations

Inputs

• apiKey (required) — Klaviyo private API key.
• operation (required) — one of the four above.
• revision — optional API revision date (header).
• email, phoneNumber — profile identifiers.
• firstName, lastName — profile name (upsert).
• metric — event name (create-event), e.g. Placed Order.
• value — optional numeric event value (e.g. order total).
• properties — optional JSON object of custom properties.
• channel — email or sms (get-campaigns).
• pageSize — optional page size (get-profiles).

Output

Publishes result (the Klaviyo JSON response body as a string) and status (the HTTP status code). create-event returns 202 Accepted with an empty body on success; the tool emits {"accepted": true, "metric": "..."}.

API key setup

1. In Klaviyo, go to Settings → API keys.
2. Click Create Private API Key, name it (e.g. intouch), and grant the scopes you need (Profiles, Events, Campaigns).
3. Copy the key (starts with pk_…) and pass it as the apiKey input.

Examples

Upsert a profile:

{
  "apiKey": "pk_xxx",
  "operation": "upsert-profile",
  "email": "[email protected]",
  "firstName": "Jane",
  "properties": "{\"plan\":\"pro\"}"
}

Trigger a flow by firing an event:

{
  "apiKey": "pk_xxx",
  "operation": "create-event",
  "email": "[email protected]",
  "metric": "Placed Order",
  "value": "129.00",
  "properties": "{\"order_id\":\"A-1001\"}"
}

List email campaigns:

{ "apiKey": "pk_xxx", "operation": "get-campaigns", "channel": "email" }

Look up a profile by email:

{ "apiKey": "pk_xxx", "operation": "get-profiles", "email": "[email protected]" }

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.