Docs / Vendor onboarding

Connect Shopify webhooks to Relin

Use this when Shopify store events need to reach your app reliably. Relin receives Shopify HTTPS webhooks, verifies the Shopify HMAC header, keeps the payload available for inspection, and helps you recover from failed downstream deliveries.

Open Relin workspace Open Shopify webhook docs

What you need

Relin access

Owner or admin access to the Relin workspace where events should land.

Shopify access

Admin access to the Shopify account or app where you configure webhooks.

Test event

A safe Shopify test event or development account you can use before production traffic.

1. Create the Shopify source in Relin

  1. In Relin, open Developer → Inbound.
  2. Click Add source.
  3. Select the Shopify tile.
  4. Name the source, for example Shopify store.
  5. Save the source and copy the ingest URL. You will paste this URL into Shopify.
Relin source picker with Shopify selected
Select Shopify from the source picker, then name the source after the store or app installation.

2. Configure Shopify

  1. Open the Shopify app or custom app that should emit webhooks.
  2. Subscribe to the webhook topics your app needs, using HTTPS delivery.
  3. Use the Relin ingest URL as the webhook endpoint URL.
  4. Make sure the app has the scopes required for each topic.
  5. Deploy or save the webhook subscription configuration.

Recommended Shopify topics

Orders

orders/create
orders/updated
orders/paid
refunds/create

Compliance

customers/data_request
customers/redact
shop/redact

3. Copy the Shopify app secret into Relin

  1. Open the app credentials for the Shopify app that signs the webhook.
  2. Copy the app client secret or webhook secret used to generate X-Shopify-Hmac-SHA256.
  3. Return to the Relin source settings page and paste it into Signing secret.
  4. Save the source.
Relin source created panel for Shopify
After the source is created, copy the ingest URL before leaving the page. The token is shown once.

4. Send a test event

  1. Trigger a subscribed Shopify event, such as creating a test order in a development store.
  2. Open Relin Events and filter to the Shopify source.
  3. Confirm the new event has signature status verified.

Shopify notes

  • Shopify requires HTTPS delivery with a valid certificate. Relin's ingest URL is already HTTPS.
  • Shopify expects a fast 2xx response. Relin acknowledges receipt quickly, then handles forwarding and retries separately.

Troubleshooting

  • No event in Relin: confirm the webhook subscription endpoint is the Relin ingest URL, not your app's endpoint.
  • Signature failed: confirm the source uses the secret from the Shopify app that emitted the webhook.
  • A subscription disappeared: Shopify can delete failing Admin API subscriptions after repeated failures; recreate it with the Relin URL.

Official references

Next