Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.outpost.pub/llms.txt

Use this file to discover all available pages before exploring further.

The Shopify integration listens for customer events in your Shopify store and turns selected customers into Outpost members. Today it is scoped to a specific subscription-tag flow; in the future it will connect Shopify purchases to Ghost subscribers more broadly.

​
How it works

Shopify sends real-time webhooks to Outpost whenever a customer is created, updated, or deleted. Outpost processes those events and updates your member list accordingly. Sync direction: Shopify → Outpost only. Changes made in Outpost are not pushed back to Shopify.

​
What syncs today

The current behavior is tag-driven. Outpost looks at the customer’s Shopify tags and acts only when they match a specific subscription-tag set:
  • Customers with subscription tags that the integration is configured to recognize are created in Outpost as complimentary members on the corresponding tier.
  • Email, first name, and last name are stored on the new member record.
  • Subsequent updates to those customers (tag changes, profile updates) keep the Outpost member in sync.
  • Customers without matching subscription tags are not imported.
The current implementation maps a fixed Shopify tag set to a fixed Outpost tier. If you need a different mapping for your store, contact support@outpost.pub during onboarding so we can configure the integration for your tag conventions and target tier.

​
Roadmap

Future work for this integration will broaden the scope so that:
  • Any Shopify purchase can be linked to a Ghost subscriber, not just customers tagged with the current subscription-tag set.
  • Tag-to-tier mapping becomes configurable in the Outpost admin.
We’ll update this page as those changes ship.

​
Setup

1

Create a Shopify custom app

In your Shopify Admin, go to Settings → Apps and sales channels → Develop apps. Create a new app and enable read access to Customers (and Orders if you want order-driven flows in the future).
2

Connect Outpost to Shopify

Go to the Shopify integration in Outpost and enter:
  • Your Shopify store URL (e.g., yourstore.myshopify.com).
  • Your Shopify Admin API access token from the custom app.
3

Add Outpost's webhook URLs in Shopify

Outpost displays the webhook URLs you need to register inside Shopify (customer create, customer update, customer delete). Paste each URL into Shopify Admin under Settings → Notifications → Webhooks, with format set to JSON. Outpost does not auto-register these — paste them manually.
4

Confirm with a test customer

Add a Shopify customer with one of the recognized subscription tags and confirm they appear in Outpost as a complimentary member on the expected tier.

​
Matching existing members

When a Shopify webhook arrives, Outpost matches the customer to an existing member by email:
  • If found — the existing member record is updated.
  • If not found — a new complimentary member is created using the Shopify subscription-tag mapping.

​
FAQ

No. Sync runs Shopify → Outpost only.
Outpost receives the deletion event and can remove the corresponding member, depending on your configuration.
Not yet. The current integration recognizes a fixed tag set and maps to a fixed tier. Configurable tag-to-tier mapping is on the roadmap.
Shopify sends webhooks in real time. Most events appear in Outpost within seconds, though they’re processed through a queue so there may be a brief delay during high-traffic periods.