---
schema_version: "1"
id: 8b4dc82c52e9ac060851cb1c771901b36c057c74a1a8b1c5240e5bebfc7e1c35
title: Create an Event Relay
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/ev_relay_create_ui.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.ev_relay_create_ui.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: aad1f2770f24c9124f0974d03467de9206dd824dcecd8fdfc5d02b5fd3bf029d
description: An event relay associates the channel in the Salesforce event bus with Amazon EventBridge using a named credential. The creation of the event relay results in a partner event source being created in Amazon EventBridge. The partner event source is created with a pending status.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Create an Event Relay

An event relay associates the channel in the Salesforce event bus with Amazon EventBridge using a named credential. The creation of the event relay results in a partner event source being created in Amazon EventBridge. The partner event source is created with a pending status.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d17197e38">User
              Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d17197e38 ">To create an event relay:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d17197e38 ">Customize Application</td>

          </tr>
        </tbody>
      </table>

1. From Setup, in the Quick Find box, enter Event Relays, and then select **Event Relays**.
2. In the Event Relays page, click **New Event Relay**. Use the event relay creation wizard and provide the requested information in each step.
    
    ![New event relay button](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/ev-relay-new-button.png)
3. Enter a label for the event relay, for example, Carbon Comparison Relay. The label appears in the event relays list view and the event relay detail page. Make sure you choose a meaningful name and try to make it unique. The name is auto populated based on the label that you provide.
    
    ![Enter a label for the event relay](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/ev-relay-new-name.png)
4. Select a named credential that contains your AWS account information from the dropdown. To create a named credential, see [Create a Named Credential for Event Relay Setup](https://help.salesforce.com/s/articleView?id=platform.ev_relay_create_named_credential.htm&release=264.0.0&type=5 "A named credential stores your AWS account information. You use the named credential later to set up an event relay. You can create a named credential in the Salesforce user interface in Setup.").
    
    ![Select a named credential for the event relay](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/ev-relay-new-credential-wizard-blurred.png)
5. Select a channel that references the events that you want to send to EventBridge from the dropdown. To create a channel, see [Create a Channel and Channel Members](https://help.salesforce.com/s/articleView?id=platform.ev_relay_create_channel_section.htm&release=264.0.0&type=5 "You can create a channel and add members by using Tooling API. A channel is a stream of events. It contains members that specify the type of events that can be received on the channel. A channel can contain a stream of platform events, including real-time event monitoring events, or change data capture events. For a channel of change data capture events, you can select the standard ChangeEvents channel instead of creating a custom channel.").
    
    ![Select a channel for the event relay](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/ev-relay-new-channel.png)
6. Select an error recovery option. This option is used when the system can't resume from the last relayed event after it recovers from an error. You can keep the default.
    
    ![Select an error recovery option for the event relay](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/ev-relay-new-recovery.png)
7. Review the summary screen, and save your changes to create the event relay.
    
    ![Event relay summary page](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/ev-relay-new-summary.png)

After you create the event relay, the event relay detail page contains the Partner Event Source Name field. This field is populated after a short delay with the name of the partner event source that’s created in Amazon EventBridge. Wait and then refresh the detail page to get the partner event source. You use this field value in the next step to find the partner event source in Amazon EventBridge.

The event relay is created in a stopped state, and no events are relayed to Amazon EventBridge. Before starting the event relay, activate the partner event source in Amazon EventBridge. You perform these steps next.