# WooCommerce

Connect a WooCommerce store as a data source: the REST API key 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
**Translation key:** platform.data-sources.connectors.woocommerce
**Search keywords:** WooCommerce, WordPress, ecommerce, store, REST API, API key, customers, orders, connect WooCommerce, WooCommerce integration, WooCommerce consent
**Related pages:** /platform/es/data-sources/connectors/woocommerce, /platform/en/data-sources/connectors, /platform/en/data-sources/connectors/shopify, /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/woocommerce/ (HTML) · https://docs.instasent.com/platform/en/data-sources/connectors/woocommerce.md (Markdown)
**Other language (es):** https://docs.instasent.com/platform/es/data-sources/connectors/woocommerce.md

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

## How to connect

WooCommerce connects with an **[API key](/platform/en/data-sources/connectors#api-key)**:
you create a REST API key in your store first and paste it into Instasent. The key is a
**Consumer Key** and a **Consumer Secret** pair.

> **Warning**: You have to create the REST API key in WooCommerce **before** connecting. The panel
> won't let you continue without it.

#### 1. Create a REST API key in WooCommerce

In your WordPress admin, open **WooCommerce → Settings → Advanced → REST API** and
create a key with **Read/Write** permissions. WooCommerce gives you a **Consumer
Key** and a **Consumer Secret**.

#### 2. Add the data source

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

#### 3. Enter your credentials and connect

On the **Connect** step, fill in the **Connection name**, your **Shop domain**, and
the **Consumer Key** and **Consumer Secret**, then connect.

#### 4. Initial import

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

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

![The WooCommerce connector page with its description, what it imports, and the contact fields it maps, with Connect WooCommerce to start](/platform/en/data-sources/images/woocommerce--1-connect.png)
*The WooCommerce connector page: what it brings into Instasent and the contact fields it maps, with Connect WooCommerce 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 WooCommerce into Instasent**, and 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**: every order and checkout
moment Instasent receives becomes something you can segment on or trigger an
automation from — a paid order to thank a buyer, an abandoned checkout to win the
sale back, a new customer to welcome. The connector covers the full order lifecycle
(*created*, *paid*, *cancelled*, *refunded*), the checkout (*started*, *updated*) and
customer events.

![The WooCommerce connector's Event triggers list: order created, updated, cancelled, paid and refunded, checkout started and updated, and customer created, updated and deleted](/platform/en/data-sources/images/woocommerce--2-event-triggers.png)
*The store events Instasent receives from WooCommerce — the order, checkout and customer moments you can build segments and automations on to recover sales and follow up on behaviour.*

## Field mapping

WooCommerce 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 WooCommerce → 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 WooCommerce's marketing status to Instasent's marketing-preference attribute
(`_accepts_marketing_*`) following the consent golden rule:

| WooCommerce 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.