Amazon EventBridge

Amazon EventBridge is a serverless event bus that allows you to connect applications using data from your own apps, integrated SaaS applications, or AWS services.

RudderStack supports Amazon EventBridge as a destination where you can seamlessly send your event data.

Find the open source code for this destination in the GitHub repository.

Connection compatibility

Destination info
Status: Generally Available Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as EVENTBRIDGE in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources

Get started

Once you have confirmed that the source platform supports sending events to EventBridge, follow these steps:

1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select AWS EventBridge.
2. Assign a name to your destination and click Continue.

Connection settings

To successfully set up EventBridge as a destination, you need to configure the following settings:

• AWS Region: Enter the AWS region in which you have created the EventBridge bus. This is a required field.
• Role-based Authentication: Enable this setting to use the RudderStack IAM role for authentication. For more information on creating an AWS IAM role for RudderStack, refer to this guide.
  • IAM Role ARN: Enter the ARN of the IAM role.

It is highly recommended to enable this setting as the access keys-based authentication method is now deprecated.

• If Role-based Authentication is disabled, you need to enter the AWS Access Key ID and AWS Secret Access Key to authorize RudderStack in order to write to the configured event bus.

In both the role-based and access key-based authentication methods, you need to set a policy specifying the required permissions for RudderStack to write to your event bus. Refer to the Policy permissions section below for more information.

• Event Bus Name: Specify the name of the event bus where you want to send the events. RudderStack sends the event to the default bus if no event bus name is specified.
• Detail Type: Specify the event’s detail type to send to EventBridge. This is a required field.
• Amazon Resource Name: This field contains an ARN (Amazon Resource Name) that identifies a resource involved in your EventBridge setup. To add multiple ARNs (for multiple targets involved in your setup), click + ADD MORE.

Policy permissions

To authorize RudderStack, you need to create an IAM policy that provides the required permission to write to your event bus. Refer to the Using Identity-Based Policies (IAM Policies) for EventBridge guide to know the applicable policies.

A sample permissions policy that allows a user to put event data into EventBridge is shown below:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "CloudWatchEventsInvocationAccess",
      "Effect": "Allow",
      "Action": ["events:PutEvents"],
      "Resource": "*"
    }
  ]
}

Sending events to EventBridge

You can map a RudderStack event to an EventBridge event in the following manner:

• Event Payload: This is the generated event payload
• Amazon Resource Name, Detail Type, Event Bus Name: These are the values you configured while setting up the destination with RudderStack.

Questions? Contact us by email or on Slack