# Shopify integration support

## Create and update Shopify customers from your Buttondown automations.

Buttondown integrates with Shopify so your [automations](/content/features/automation/index.html) can read and update the customers in your store: looking a customer up by email and then creating them, updating their tags, or changing their email marketing consent.

Every one of these is **triggered by an event in Buttondown** (such as someone subscribing) — Buttondown does not receive events from Shopify, so a change on the Shopify side won't automatically trigger anything in Buttondown. To bring existing Shopify customers into Buttondown, use the CSV import described below (or a tool like Zapier).

## Getting your Shopify API key

To connect Buttondown to your Shopify store, you'll need to create a custom app in Shopify:

1. In your Shopify admin, go to **Settings** → **Apps and sales channels** → **Develop apps**.
2. Click **Create an app** and give it a name (e.g. "Buttondown").
3. Click **Configure Admin API scopes** and enable the following scopes:
   - `read_customers`
   - `write_customers`
4. Click **Save**, then go to the **API credentials** tab and click **Install app**.
5. Copy the **Admin API access token**. This is the value you'll paste into Buttondown.

These are the only two scopes Buttondown needs. The integration only interacts with the Shopify Customers API — it does not access orders, products, or any other data.

## Connecting Shopify to Buttondown

1. In Buttondown, go to **Settings** → **Integrations** → **Shopify**.
2. Enter your **Shopify URL** (e.g. `your-store.myshopify.com`).
3. Enter the **Admin API access token** you copied from Shopify.
4. Click **Save**.

## What you can do

Once connected, you can set up [automations](/content/features/automation/index.html) that trigger Shopify actions when events happen in Buttondown:

- **Create a customer** in Shopify when someone subscribes to your newsletter
- **Set tags** on a Shopify customer (e.g. to segment them based on newsletter activity)
- **Subscribe or unsubscribe** a customer from Shopify email marketing

These actions all run in one direction: a Buttondown event (such as a new subscriber) triggers an action in Shopify. Buttondown does not currently listen for events coming _from_ Shopify, so a new customer in Shopify won't automatically start a Buttondown automation on its own.

## Importing subscribers from Shopify

Buttondown supports importing subscribers from a Shopify customer CSV export. Go to **Subscribers** → **Import** and upload your Shopify CSV file.
