webhooks

Shopify Webhooks Implementation Guide

When to Use This Skill

Use webhooks when you need to:

• Receive real-time event notifications from Shopify (orders, products, customers, fulfillments, etc.)
• Sync external systems with Shopify data changes
• Trigger automated workflows based on shop events
• Monitor GDPR compliance actions (customer data erasure, shop deletion)
• Process bulk operations completion
• Update inventory or pricing in third-party systems

Webhook Delivery Methods

1. HTTPS (Traditional)

Most common delivery method. Webhooks sent as POST requests to your publicly accessible HTTPS endpoint.

Characteristics:

• Requires public HTTPS endpoint (443, TLS 1.2+)
• Real-time delivery (within seconds)
• Max 5 retries over 48 hours (exponential backoff: 10s, 30s, 1m, 2m, 8h)
• Request timeout: 30 seconds
• Payload size: max 2MB
• Rate limiting: respect Shopify API rate limits

Configuration Example:

{
  "deliveryMethod": {
    "https": {
      "address": "https://myapp.example.com/webhooks/shopify"
    }
  },
  "query": "subscription { event { id occurredAt } }",
  "filter": "orders/created"
}

2. AWS EventBridge

Asynchronous delivery via AWS EventBridge. Events queued in partner event bus.

Characteristics:

• No public endpoint needed
• Queued delivery (managed by EventBridge)
• Scalable, event-sourcing ready
• Requires AWS EventBridge partner event bus setup
• Lower operational overhead
• Better for high-volume events

Setup Steps:

# 1. Shopify creates AWS partner event bus in your account
# 2. Your app subscribes to webhooks via EventBridge configuration
# 3. Events appear in partner event bus: aws.partner/shopify.com/[app-id]/[account-id]

# 3. Create rule to route to your targets (SQS, Lambda, etc.)
aws events put-rule \
  --name shopify-webhook-router \
  --event-bus-name aws.partner/shopify.com/12345/default \
  --state ENABLED

Example Event:

{
  "detail-type": "orders/created",
  "detail": {
    "id": "gid://shopify/Order/123456",
    "displayOrderNumber": "#1001",
    "email": "[email protected]",
    "createdAt": "2026-05-04T14:30:00Z",
    "totalPriceSet": {
      "shopMoney": {
        "amount": "299.99",
        "currencyCode": "USD"
      }
    }
  },
  "source": "aws.partner/shopify.com/12345/default"
}