# Receiving events from a SaaS partner with Amazon EventBridge
<a name="eb-saas"></a>

To receive events from SaaS partner applications and services, you need a *partner event source* from the partner. A partner event source is a resource created by a partner that you can then accept as an event source. To accept the partner event source, you create a custom event bus and match it to the partner event source.

![An SaaS partner sends an event to a partner event source, which sends it to the partner event bus.](http://docs.amazonaws.cn/en_us/eventbridge/latest/userguide/images/bus-saas_eventbridge_conceptual.svg)


**Topics**
+ [Supported SaaS partner integrations](#eb-supported-integrations)
+ [Configuring Amazon EventBridge to receive events from a SaaS integration](#eb-saas-integration)
+ [Receiving SaaS events from Amazon Lambda function URLs in Amazon EventBridge](eb-saas-furls.md)
+ [Receiving events from Salesforce in Amazon EventBridge](eb-saas-salesforce.md)

## Supported SaaS partner integrations
<a name="eb-supported-integrations"></a>

EventBridge supports the following SaaS partner integrations:
+ [https://console.amazonaws.cn/events/#/partners/adobe.com?page=overview](https://console.amazonaws.cn/events/#/partners/adobe.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/appflow-salesforce.com?page=overview](https://console.amazonaws.cn/events/#/partners/appflow-salesforce.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/apptrail.com?page=overview](https://console.amazonaws.cn/events/#/partners/apptrail.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/atlan.com?page=overview](https://console.amazonaws.cn/events/#/partners/atlan.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/auth0.com?page=overview](https://console.amazonaws.cn/events/#/partners/auth0.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/authress.io?page=overview](https://console.amazonaws.cn/events/#/partners/authress.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/benchling.com?page=overview](https://console.amazonaws.cn/events/#/partners/benchling.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/bigcommerce.com?page=overview](https://console.amazonaws.cn/events/#/partners/bigcommerce.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/blitline.com?page=overview](https://console.amazonaws.cn/events/#/partners/blitline.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/buildkite.com?page=overview](https://console.amazonaws.cn/events/#/partners/buildkite.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/chargebee.com?page=overview](https://console.amazonaws.cn/events/#/partners/chargebee.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/checkout.com?page=overview](https://console.amazonaws.cn/events/#/partners/checkout.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/clevertap.com?page=overview](https://console.amazonaws.cn/events/#/partners/clevertap.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/cloudamqp.com?page=overview](https://console.amazonaws.cn/events/#/partners/cloudamqp.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/commercetools.com?page=overview](https://console.amazonaws.cn/events/#/partners/commercetools.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/datadoghq.com?page=overview](https://console.amazonaws.cn/events/#/partners/datadoghq.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/energysys.com?page=overview](https://console.amazonaws.cn/events/#/partners/energysys.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/epsagon.com?page=overview](https://console.amazonaws.cn/events/#/partners/epsagon.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/freshworks.com?page=overview](https://console.amazonaws.cn/events/#/partners/freshworks.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/genesys.com?page=overview](https://console.amazonaws.cn/events/#/partners/genesys.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/gladly.com?page=overview](https://console.amazonaws.cn/events/#/partners/gladly.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/gs2.io?page=overview](https://console.amazonaws.cn/events/#/partners/gs2.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/guidewire.com?page=overview](https://console.amazonaws.cn/events/#/partners/guidewire.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/hitachi-solutions.co.jp?page=overview](https://console.amazonaws.cn/events/#/partners/hitachi-solutions.co.jp?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/ilert.com?page=overview](https://console.amazonaws.cn/events/#/partners/ilert.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/jiraservicemanagement.com?page=overview](https://console.amazonaws.cn/events/#/partners/jiraservicemanagement.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/karte.io?page=overview](https://console.amazonaws.cn/events/#/partners/karte.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/kloudless.com?page=overview](https://console.amazonaws.cn/events/#/partners/kloudless.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/mackerel.io?page=overview](https://console.amazonaws.cn/events/#/partners/mackerel.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/mongodb.com?page=overview](https://console.amazonaws.cn/events/#/partners/mongodb.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/newrelic.com?page=overview](https://console.amazonaws.cn/events/#/partners/newrelic.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/nops.io?page=overview](https://console.amazonaws.cn/events/#/partners/nops.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/okta.com?page=overview](https://console.amazonaws.cn/events/#/partners/okta.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/onelogin.com?page=overview](https://console.amazonaws.cn/events/#/partners/onelogin.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/operata.com?page=overview](https://console.amazonaws.cn/events/#/partners/operata.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/opsgenie.com?page=overview](https://console.amazonaws.cn/events/#/partners/opsgenie.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/pagerduty.com?page=overview](https://console.amazonaws.cn/events/#/partners/pagerduty.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/payshield.com.au?page=overview](https://console.amazonaws.cn/events/#/partners/payshield.com.au?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/rhythmsoftware.com?page=overview](https://console.amazonaws.cn/events/#/partners/rhythmsoftware.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/rightsline.com?page=overview](https://console.amazonaws.cn/events/#/partners/rightsline.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/rootly.com?page=overview](https://console.amazonaws.cn/events/#/partners/rootly.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/saasus.io?page=overview](https://console.amazonaws.cn/events/#/partners/saasus.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/sailpoint.com?page=overview](https://console.amazonaws.cn/events/#/partners/sailpoint.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/scalr.com?page=overview](https://console.amazonaws.cn/events/#/partners/scalr.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/segment.com?page=overview](https://console.amazonaws.cn/events/#/partners/segment.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/shopify.com?page=overview](https://console.amazonaws.cn/events/#/partners/shopify.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/signalfx.com?page=overview](https://console.amazonaws.cn/events/#/partners/signalfx.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/site24x7.com?page=overview](https://console.amazonaws.cn/events/#/partners/site24x7.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/snowcatcloud.com?page=overview](https://console.amazonaws.cn/events/#/partners/snowcatcloud.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/snyk.io?page=overview](https://console.amazonaws.cn/events/#/partners/snyk.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/stax.io?page=overview](https://console.amazonaws.cn/events/#/partners/stax.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/stripe.com?page=overview](https://console.amazonaws.cn/events/#/partners/stripe.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/sugarcrm.com?page=overview](https://console.amazonaws.cn/events/#/partners/sugarcrm.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/symantec.com?page=overview](https://console.amazonaws.cn/events/#/partners/symantec.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/tealium.com?page=overview](https://console.amazonaws.cn/events/#/partners/tealium.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/thundra.io?page=overview](https://console.amazonaws.cn/events/#/partners/thundra.io?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/triggermesh.com?page=overview](https://console.amazonaws.cn/events/#/partners/triggermesh.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/whispir.com?page=overview](https://console.amazonaws.cn/events/#/partners/whispir.com?page=overview)
+ [https://console.amazonaws.cn/events/#/partners/zendesk.com?page=overview](https://console.amazonaws.cn/events/#/partners/zendesk.com?page=overview)
+ [Amazon Seller Partner API](https://console.amazonaws.cn/events/#/partners/sellingpartnerapi.amazon.com?page=overview) 

## Configuring Amazon EventBridge to receive events from a SaaS integration
<a name="eb-saas-integration"></a>

Configuring EventBridge to receive partner events consists of two main steps:
+ Creating the partner event source
+ Associating that partner source with a partner event bus
**Note**  
Any events published by a partner to a partner event source that has not been associated with an event bus will be immediately dropped. Those events will not be persisted at rest in EventBridge.

**Create a partner event source (console only)**

1. Open the Amazon EventBridge console at [https://console.amazonaws.cn/events/](https://console.amazonaws.cn/events/).

1. In the navigation pane, choose **Partner event sources**.

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

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

1. In the navigation pane, choose **Partner event sources**.

1. 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.

**Associate the partner source with a partner event bus (console)**

1. In the EventBridge console, choose **Partner event sources** in the navigation pane.

1. 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.

**Associate the partner source with a partner event bus (Amazon CLI)**
+ Use [https://docs.amazonaws.cn/cli/latest/reference/events/create-event-bus.html](https://docs.amazonaws.cn/cli/latest/reference/events/create-event-bus.html) to create a partner event bus associated with the partner event source. 

  Both `name` and `event-source-name` should be set to the partner event source name.

  For example:

  ```
  aws events create-event-bus \
      --name "{{aws.partner/saas-integration/name}}" \
      --event-source-name "{{aws.partner/saas-integration/name}}" \
      --region {{us-east-1}}
  ```

  After EventBridge creates the event bus, you can call [https://docs.amazonaws.cn/cli/latest/reference/events/describe-event-source.html](https://docs.amazonaws.cn/cli/latest/reference/events/describe-event-source.html) to return details about the partner source. The `State` of the partner source should be `ACTIVE`.

  ```
  aws events describe-event-source
  --name "{{aws.partner/saas-integration/name}}"
  ```
**Note**  
Calling [https://docs.amazonaws.cn/cli/latest/reference/events/put-permission.html](https://docs.amazonaws.cn/cli/latest/reference/events/put-permission.html) on a partner event bus returns an error. Only the partner account of the event source associated with the partner event bus is permitted to send events to it.

**Associate the partner source with a partner event bus (Amazon CloudFormation)**

1. Create a Amazon CloudFormation template that provisions an [https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html) resource with the partner event source. 

   Both `Name` and `EventSourceName` should be set to the partner event source name. For example:

   ```
   AWSTemplateFormatVersion: 2010-09-09
   
   Description: 
      Cloudformation template to create Event Bus for receiving partner events
   
   Resources:
     ExamplePartnerEventBus:
       Type: AWS::Events::EventBus
       Properties:
         EventSourceName: '{{aws.partner/saas-integration/name}}'
         Name: '{{aws.partner/saas-integration/name}}'
   ```

1. Use [https://docs.amazonaws.cn/cli/latest/reference/cloudformation/create-stack.html](https://docs.amazonaws.cn/cli/latest/reference/cloudformation/create-stack.html) or the Amazon CloudFormation console to create a stack from the template. For example:

   ```
   aws cloudformation create-stack --stack-name {{eventbridge-saas}} --template-body {{file://template.yml}} --region {{us-east-1}}
   ```
**Note**  
Including an [https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbuspolicy.html](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbuspolicy.html) resource for the partner event bus in your template will result in an error. Only the partner account of the event source associated with the partner event bus is permitted to send events to it.