TTruefold
← All guides

Connect Klaviyo

Truefold reads your Klaviyo events, campaigns, and flows so your email and SMS activity can be modeled alongside your store and ad data.

Klaviyo uses a private API key — you generate one in Klaviyo and paste it into Truefold. There's no OAuth pop-up.

1. Create a private API key in Klaviyo

  1. Log in to Klaviyo and open Settings → API keys (Account name, top-right → Settings → API keys).

  2. Click Create Private API Key.

  3. Give it a name you'll recognize, e.g. Truefold.

  4. Set the access level to Custom Key and grant Read access to:

    ScopeWhy Truefold needs it
    eventsEmail/SMS activity (sends, opens, clicks, orders)
    campaignsCampaign metadata
    flowsFlow metadata

    You can grant broader read access if you prefer — Truefold only reads the three above.

  5. Click Create and copy the key. It looks like pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

Use the private key, not the public one. Public keys start with a short site ID; the key you need starts with pk_.

2. Paste it into Truefold

  1. In Truefold, go to Sources → Add source → Klaviyo → Connect.
  2. Paste the pk_... private key and click Connect Klaviyo.

Truefold validates the key immediately. If it's accepted, your Klaviyo source is created and the first sync begins.

What Truefold does and doesn't read

  • Reads: event, campaign, and flow data for modeling.
  • Does not read or store: your customers' names or email addresses in plain text. Where an identifier is needed to link records, it is stored as a one-way hash.

Troubleshooting

  • "Klaviyo rejected the API key" — the key is wrong, revoked, or missing read access to flows, campaigns, or events. Regenerate it with the scopes above.
  • Pasted the public key — Truefold only accepts private keys (they start with pk_).