# Magento

Connect a Magento store as a data source: the integration credentials it needs, the customers and orders it syncs, how its fields map to Instasent attributes, and how to map its marketing status to consent.

**Language:** en
**Audience:** platform
**TLDR:** Magento is a native connector that syncs your store's customers and orders into Instasent on a one-way periodic sync. You connect it with an integration you create in Magento (System → Integrations), which hands you four values (Consumer Key and Secret, Access Token and Secret) that you paste into Instasent with the store domain and Store Code. Only Magento Community Edition 2.x is supported.
**Translation key:** platform.data-sources.connectors.magento
**Search keywords:** Magento, Adobe Commerce, ecommerce, store, API key, integration, consumer key, access token, customers, orders, connect Magento, Magento integration, Magento consent
**Related pages:** /platform/es/data-sources/connectors/magento, /platform/en/data-sources/connectors, /platform/en/data-sources/connectors/woocommerce, /platform/en/data-sources/managing, /platform/en/consent
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/en/llms.txt
**This page:** https://docs.instasent.com/platform/en/data-sources/connectors/magento/ (HTML) · https://docs.instasent.com/platform/en/data-sources/connectors/magento.md (Markdown)
**Other language (es):** https://docs.instasent.com/platform/es/data-sources/connectors/magento.md

Magento is the native connector for Magento stores. Once connected, it syncs your
store's customers and orders into Instasent so your audience and purchase events stay
current.

> **Note**: Only **Magento Community Edition 2.x** is supported.

## How to connect

Magento connects with an **[API key](/platform/en/data-sources/connectors#api-key)**:
you create an **integration** in your store first and paste its credentials into
Instasent, along with your store domain. A Magento integration hands you four values —
a **Consumer Key** and **Consumer Secret**, and an **Access Token** and **Access Token
Secret**.

> **Warning**: Create the integration in Magento **before** connecting. The panel won't let you
> continue without valid credentials.

#### 1. Create an integration in Magento

In your Magento admin, go to **System → Integrations → Add New Integration**. Grant
access to **all resources**, and leave the Callback URL and Identity Link URL empty.
Activate the integration to get the tokens — Magento then shows you the **Consumer
Key**, **Consumer Secret**, **Access Token** and **Access Token Secret**.

#### 2. Add the data source

In **Data sources**, select **Add data source** and choose **Magento** from the
Integrations section.

#### 3. Enter your credentials and connect

On the **Connect** step, fill in your **Shop domain**, the **Store Code** (usually
`default` — you'll find it under **Stores → All Stores**), and the four integration
values: **Consumer Key**, **Consumer Secret**, **Access Token** and **Access Token
Secret**. Then connect.

#### 4. Initial import

The connector imports your existing customers and orders, then keeps syncing
periodically.

After connecting, the wizard continues through **Mapping**, **Merge** and **Tags**, the
same steps as a CSV import.

![The Magento connector page with its description, what it imports, and the contact fields it maps, with Connect Magento to start](/platform/en/data-sources/images/magento--1-connect.png)
*The Magento connector page: what it brings into Instasent and the contact fields it maps, with Connect Magento to start.*

## What it syncs

- **Contacts** — your store's customers, with name, email and phone.
- **Orders** — purchase events for use in segments and automations.

The direction is one-way, **from Magento into Instasent**, with a periodic sync that
keeps contacts and orders current. Contacts unify by email and phone — see
[unification](/platform/en/data-sources/managing#how-unification-works).

### The events it brings in

The real value of the store connection is its **events**: each order and checkout
moment Instasent receives becomes something you can segment on or trigger an
automation from — a paid order to thank a buyer, a shipped order to keep them
posted, an in-progress checkout to nudge. The connector covers order events
(*created*, *updated*, *paid*, *shipped*) and checkout events (*started*, *updated*).

![The Magento connector's Event triggers list: order created, updated, paid and shipped, and checkout started and updated](/platform/en/data-sources/images/magento--2-event-triggers.png)
*The store events Instasent receives from Magento — the order and checkout moments you can build segments and automations on to recover sales and react to purchase behaviour.*

## Field mapping

Magento customer fields map to the matching Instasent attributes (email to `_email`,
phone to `_phone_mobile`, name fields to theirs), and order data arrives as ecommerce
events. Confirm the mapping on setup; see
[field mapping](/platform/en/data-sources/managing#field-mapping).

## Consent mapping

{/* VERIFY: the exact Magento → Instasent consent mapping is not yet confirmed. The mapping below applies the consent golden rule; confirm against the connector's actual behaviour before treating it as definitive. */}

Map Magento's marketing status to Instasent's marketing-preference attribute
(`_accepts_marketing_*`) following the consent golden rule:

| Magento status     | Instasent value | Meaning                     |
| ------------------ | --------------- | --------------------------- |
| Opted in           | `true`          | Accepted marketing          |
| No status recorded | `null`          | No preference               |
| Opted out          | `false`         | Actively declined marketing |

Only an **active opt-out** becomes `false`. A customer with no recorded marketing status
maps to **no preference** (`null`), never to `false`. See
[Consent](/platform/en/consent/marketing-preference-vs-suppression).

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.