Migrate from Klaviyo: what moves, permissions, limits
What Shuttio reads from Klaviyo, where it lands in Odoo, which permissions it needs and why, and what does not move.
Last updated: 20 November 2026
A private API key with read access (Settings, API keys). Shuttio reads that account only, at a.klaviyo.com, and never writes to Klaviyo.
Object by object: What objects are supported for Klaviyo migrations.
What Shuttio reads and moves
The list below describes the move into Odoo. Where Clarify or Odoo differ, the destination's own article says so.
- Lists: As mailing lists. A list whose name an active list already has in Odoo is used as it is, not changed. Two Klaviyo lists with the same name arrive as "Name (id)".
- Profiles: As Email Marketing contacts with name, email, company (organization) and country, and a subscription to each of their lists. One contact per email, however many lists the person is on. No Odoo contact is created. A contact already in the list with the same email is matched and left unchanged.
- Status: A profile Klaviyo says is subscribed joins its list as subscribed. A profile that unsubscribed from one list is opted out of that list only. A profile Klaviyo suppresses, or whose email consent is unsubscribed, is opted out of every list. A profile with no consent on record (never subscribed) is subscribed as opted out, never as subscribed.
- Blacklist: Off unless you tick it: the emails Klaviyo has suppressed are also added to Odoo's blacklist, which stops every mailing to them. A profile who left one list only is never blacklisted. Removing the migration removes the entries it added.
- Custom properties: Phone, job title, city, region, postal code and your own profile properties are offered on the field review as columns to send to an Odoo field; a property with no match is left out.
Where each thing lands
| Klaviyo object | In Odoo |
|---|---|
| Lists | Mailing lists (Odoo Email Marketing) |
| Contacts | Email Marketing contacts (no Odoo contact is created) |
Notes, tasks, meetings, calls, files, owners and lists depend on the destination. This is the row for Klaviyo, generated from the same tables the runner uses:
Into Odoo
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Klaviyo | Lists, Contacts | No | No | No | No | No | No | No | No |
Each destination's own article says how its data is written: Odoo.
Permissions and why
| What | Why Shuttio needs it |
|---|---|
| A private API key | Klaviyo has no OAuth for this. Create the key in Klaviyo under Settings, API keys, Create private API key, with read access to accounts, lists, profiles, campaigns and templates. Shuttio sends the key only to a.klaviyo.com, checks it against your account before it saves anything, and never writes to Klaviyo. |
Klaviyo limits requests per account in a short and a longer window; Shuttio reads one request at a time and pauses the run if Klaviyo asks it to slow down, until you resume it. The key is stored encrypted and deleted 14 days after the migration finishes. You can delete it at any time in Klaviyo. Klaviyo moves with your Odoo API key and needs Odoo's Email Marketing app.
Known limits
- Campaign statistics: They are not records in Email Marketing; Odoo keeps its own mailings and statistics.
- Flows, templates, metrics and events, SMS: Odoo has no matching object to hold them.
- Segments: A segment is a saved condition, not a list of people; the profiles on your lists come across, the conditions do not.
- Profiles on no list, and profiles with no email: A mailing contact needs a list to belong to and an email to send to. A profile with only a phone number is refused with its reason in the Errors tab.
- A person on two lists: Becomes one Email Marketing contact with a subscription to each list, opted out in the lists where Klaviyo says so.
- Odoo without the Email Marketing app: The run stops with a sentence before anything is written; install Email Marketing, then start again.
- The Odoo app and the import package: They do not write Email Marketing records yet; Klaviyo moves with your Odoo API key.
- Rate limits: Klaviyo limits how many requests an account makes. Shuttio reads one request at a time with a short pause, waits as Klaviyo asks, and pauses the run if Klaviyo still pushes back; Resume carries on.
- Emails: Shuttio reads no sent emails or flows from Klaviyo, only lists and their profiles.
Not answered here? Email help@shuttio.com.