Integrating with Shopify

Buttondown integrates with Shopify so your automations 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).

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.

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.

Once connected, you can set up automations 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.

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