Amazon EventBridge webhook delivery

EventBridge is a serverless, event-driven alternative to receiving webhooks through standard HTTP. Integrating with EventBridge lets you send event data to AWS directly, instead of handling that traffic yourself.

The following diagram shows the workflow to integrate your app with EventBridge:

1. In your Partner Dashboard, set up an event source. This tells Shopify to send events to AWS.

2. In the AWS console, associate your event source with an event bus.

3. Create rules for the event bus so that AWS knows what to do with the events received. You can route events to SQS, Lambda, or another, similar service.

4. Subscribe to webhooks using the GraphQL Admin API or REST Admin API. Use your partner event source Amazon Resource Number (ARN) supplied in your requests. You obtain the ARN from the AWS console.

• You're familiar with how webhooks work.

• You're familiar with the webhooks best practices.

• You're authenticated with the GraphQL Admin API or REST Admin API.

• You've created an app.

• You've set up your AWS Lambda function, SQS queue, or other EventBridge destination.

• You have your 12-digit Amazon Web Services (AWS) Account ID from the AWS console.

To begin integrating your app with EventBridge, set up an event source to tell Shopify to send events to AWS.

1. Navigate to your app's settings page in the Partner Dashboard or Shopify admin:

   Partner Dashboard Shopify admin

   1. In your Partner Dashboard, go to Apps.
   2. Click the name of your app.
   3. Click App setup.

   1. In your Shopify admin, go to Settings.
   2. Click Apps and sales channels.
   3. Click Develop apps for your store.
   4. Click the name of your app.
   5. Click Configuration.
   6. Next to Admin API integration, click Configure.

2. Under Amazon EventBridge, click Create source.

3. Paste your AWS account ID, and choose your AWS region.

   You need the AWS region when you associate an event bus with the source.

4. Provide a unique event source name.

   Each event source requires a unique name. If you have multiple apps, then consider a name that matches your app.

5. Click Create.

After you set up an event source to deliver Shopify events to AWS, associate the source with a bus to handle events.

1. In the AWS console, under EventBridge, navigate to the Partner event sources page.

2. In the Region drop-down list, select the AWS region that you chose when you set up your event source.

   These regions must match for the event bus to connect with the event source.

3. Click the event source that you created, and note the ARN found under Partner event source ARN.

   You need this address to subscribe to a webhook.

4. Click Associate with event bus.

5. On the next page, click Associate.

EventBridge groups and sorts the events that your event source sends based on the rules that you define. After you set up your event source and associate it with an event bus, create a rule that tells AWS what to do with events it receives on the bus.

To define multiple rules, repeat this step for each rule.

1. In the AWS console navigation menu, click Rules.

2. In the drop-down list, select your event bus.

3. Click Create rule.

4. Provide a rule name.

5. Provide a description for the rule.

6. In the Define pattern section, choose Event pattern, and select Pre-defined pattern by service.

   You can also define a custom event pattern for your rule.

7. In the list of providers, choose All Events.

8. In the Service name drop-down list, select Shopify.

   This makes sure that only events that Shopify sends are processed by this rule.

9. In the Select event bus section, select the event bus that will use this rule.

10. In the Select targets section, choose a Lambda function or SQS queue.

    Events processed by this rule will be sent to the function or queue that you select.

11. Click Create.

When you create a rule, you can process events separately depending on factors like which shop generated the event or which resource triggered the event.

Event patterns in EventBridge rules have the same structure as the payloads that they match. Matching values are added to an array and compared using OR. You can also match by prefix using the prefix key.

1. In the Define pattern section, select Event pattern.

2. Select Custom pattern.

3. Provide a custom pattern that matches the structure of an EventBridge payload.

4. Click Save.

Use the following pattern to match on a specific shop domain:

Use the following pattern to match all products events:

Subscribe to webhooks when your app is installed on a shop and the OAuth flow completes.

Webhook data is divided by topic. Refer to the GraphQL Admin API or REST Admin API reference for the complete list of supported webhook topics.

The following examples show you how to subscribe to a webhook using GraphQL and REST.

You can use the information in EventBridge payloads to define a custom event pattern in EventBridge.

The following is an example payload from EventBridge:

Occasionally, a shop might have very large resources. If a Shopify resource would result in a payload larger than 255 KB, then a special payload is sent with the following error message. You can use the resource ID in the X-Shopify-Product-Id field to request the resource using the REST Admin or GraphQL Admin API.

• Test your configuration by manually triggering a webhook delivery using the Shopify CLI webhook trigger command. Manually triggering webhooks doesn't test your webhook subscriptions.

• Learn how to manage webhooks for different API versions.

• Learn about the available topics for REST Admin API webhooks.

• Learn about the available topics for GraphQL Admin API webhooks.