Receiving events from a SaaS partner with Amazon EventBridge - Amazon EventBridge

Receiving events from a SaaS partner with Amazon EventBridge

To receive events from SaaS partner applications and services, you need a partner event source from the partner. Then you can create a partner event bus and match it to the partner event source.

Supported SaaS partner integrations

EventBridge supports the following SaaS partner integrations:

Partner event sources are available in the following Regions.

Code Name

us-east-1

US East (N. Virginia)

us-east-2

US East (Ohio)

us-west-1

US West (N. California)

us-west-2

US West (Oregon)

ca-central-1

Canada (Central)

eu-central-1

Europe (Frankfurt)

eu-west-1

Europe (Ireland)

eu-west-2

Europe (London)

eu-west-3

Europe (Paris)

eu-north-1

Europe (Stockholm)

eu-south-1

Europe (Milan)

af-south-1

Africa (Cape Town)

ap-east-1

Asia Pacific (Hong Kong)

ap-northeast-1

Asia Pacific (Tokyo)

ap-northeast-2

Asia Pacific (Seoul)

ap-southeast-1

Asia Pacific (Singapore)

ap-southeast-2

Asia Pacific (Sydney)

ap-south-1

Asia Pacific (Mumbai)

sa-east-1

South America (São Paulo)

Configuring Amazon EventBridge to receive events from a SaaS integration

The following procedure describes how to configure EventBridge to receive events from a SaaS integration partner.

To receive events from an SaaS partner

  1. Open the Amazon EventBridge console at https://console.aws.amazon.com/events/.

  2. In the navigation pane, choose Partner event sources.

  3. Find the partner that you want and then choose Set up for that partner.

  4. To copy your account ID to the clipboard, choose Copy.

  5. In the navigation pane, choose Partner event sources.

  6. Go to the partner's website and follow the instructions to create a partner event source using your account ID. The event source that you create is available to only your account.

  7. Go back to the EventBridge console and choose Partner event sources in the navigation pane.

  8. Select the button next to the partner event source and then choose Associate with event bus.

    The status of the event source changes from Pending to Active, and the name of the event bus updates to match the partner event source name. You can now start creating rules that match events from the partner event source. For more information, see Creating a rule that matches SaaS partner events.

Creating a rule that matches SaaS partner events

Before you can create rules for events from SaaS partner applications and services, you need a partner event bus. Then you can match the partner event bus to the partner event source. For more information, see Receiving events from a SaaS partner with Amazon EventBridge.

To create a rule that matches an event from a SaaS partner

  1. Open the Amazon EventBridge console at https://console.aws.amazon.com/events/.

  2. In the navigation pane, choose Rules.

  3. Choose Create rule.

  4. Enter a name and description for the rule.

  5. For Define pattern, choose Event pattern.

  6. Choose Pre-defined pattern by service.

  7. For Service provider, choose Service partners.

  8. For Service name, choose the name of the partner.

  9. For Event type, choose All Events or choose the type of event to use for this rule. If you choose All Events, all events that come from this partner event source match the rule.

  10. (Optional) To customize the event pattern, choose Edit, make your changes, and then choose Save.

  11. For Service event bus, select the event bus that corresponds to this partner.

  12. For Select targets, choose the AWS service that is to act when this type of event occurs.

  13. In the other fields in this section, enter information specific to this target type, if any is needed.

  14. For many target types, EventBridge needs permissions to send events to the target. In these cases, EventBridge can create the IAM role needed for your rule to run:

    • To create an IAM role automatically, choose Create a new role for this specific resource

    • To use an IAM role that you created before, choose Use existing role

  15. (Optional) Choose Add target to add another target for this rule.

  16. (Optional) Enter one or more tags for the rule. For more information, see Amazon EventBridge tags.

  17. Choose Create.