# 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 its marketing status is imported as 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, newsletter, newsletter subscription
**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

Magento's consent is its **newsletter subscription**, and a newsletter is email: it sets only
the **email** marketing preference. Magento has no SMS consent, so it never changes the SMS
preference, which stays as your other sources or Instasent record it.

| Magento newsletter status                     | Instasent value | Meaning                  |
| --------------------------------------------- | --------------- | ------------------------ |
| Subscribed                                    | `true`          | Accepted email marketing |
| Unsubscribed                                  | `false`         | Declined email marketing |
| Not Activated, Unconfirmed, or not subscribed | `null`          | No preference            |

Only an **unsubscribe** from the newsletter becomes a decline; a customer who never subscribed
arrives at **no preference**. An unsubscribe holds even if another data source records the
contact as subscribed to email (see [When your sources disagree](/platform/en/consent/marketing-preference-vs-suppression#when-your-sources-disagree)), and the general rules every connector follows are
in [How connectors import consent](/platform/en/data-sources/connectors#how-connectors-import-consent).

---

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.
