This article describes steps to subscribe to events that originate in a system owned or managed by a partner (SaaS, Enterprise Resource Planning (ERP), etc.).

High-level steps

Here are the steps that a subscriber needs to perform to receive events from a partner.

1. Register the Event Grid resource provider with your Azure subscription.
2. Authorize partner to create a partner topic in your resource group.
3. Request partner to enable events flow to a partner topic.
4. Activate partner topic so that your events start flowing to your partner topic.
5. Subscribe to events.

Register the Event Grid resource provider

Unless you've used Event Grid before, you'll need to register the Event Grid resource provider. If you’ve used Event Grid before, skip to the next section.

In the Azure portal, do the following steps:

1. On the left menu, selectSubscriptions.

2. Select thesubscription you want to use for Event Grid from the subscription list.

3. On theSubscription page, selectResource providers underSettings on the left menu.

4. Search forMicrosoft.EventGrid, and confirm that theStatus isNot Registered.

5. SelectMicrosoft.EventGrid in the provider list.

6. SelectRegister on the command bar.

   

7. Refresh to make sure the status ofMicrosoft.EventGrid is changed toRegistered.

   

Authorize partner to create a partner topic

You must grant your consent to the partner to create partner topics in a resource group that you designate. This authorization has an expiration time. It's effective for the time period you specify between 1 to 365 days.

Following example shows the way to create a partner configuration resource that contains the partner authorization. You must identify the partner by providing either itspartner registration ID or thepartner name. Both can be obtained from your partner, but only one of them is required. For your convenience, the following examples leave a sample expiration time in the UTC format.

Azure portal

1. Sign in to theAzure portal.

2. In the search bar at the top, enterPartner Configurations, and selectEvent Grid Partner Configurations underServices in the results.

3. On theEvent Grid Partner Configurations page, selectCreate Event Grid partner configuration button on the page (or) select+ Create on the command bar.

   

4. On theCreate Partner Configuration page, do the following steps:

   1. In theProject Details section, select theAzure subscription and theresource group where you want to allow the partner to create a partner topic.

   2. In thePartner Authorizations section, specify a default expiration time for partner authorizations defined in this configuration.

   3. To provide your authorization for a partner to create partner topics in the specified resource group, select+ Partner Authorization link.

      

5. On theAdd partner authorization to create resources page, you see a list ofverified partners. A verified partner is a partner whose identity has been validated by Microsoft. You can select a verified partner, and selectAdd button at the bottom to give the partner the authorization to add a partner topic in your resource group. This authorization is effective up to the expiration time.

   You also have an option to authorize anon-verified partner. Unless the partner is an entity that you know well, for example, an organization within your company, it's strongly encouraged that you only work with verified partners. If the partner isn't yet verified, encourage them to get verified by asking them to contact the Event Grid team at askgrid@microsoft.com.

   1. To authorize averified partner:

      1. Select the partner from the list.

      2. Specifyauthorization expiration time.

      3. selectAdd.

         

   2. To authorize a nonverified partner, selectAuthorize non-verified partner, and follow these steps:

      1. Enter thepartner registration ID. You need to ask your partner for this ID.

      2. Specify authorization expiration time.

      3. SelectAdd.

         

         Important

         Your partner won't be able to create resources (partner topics) in your Azure subscription after the authorization expiration time.

6. Back on theCreate Partner Configuration page, verify that the partner is added to the partner authorization list at the bottom.

7. SelectReview + create at the bottom of the page.

   

8. On theReview page, review all settings, and then selectCreate to create the partner registration.

Request partner to enable events flow to a partner topic

Here's the list of partners and a link to submit a request to enable events flow to a partner topic.

• Auth0
• Microsoft Graph API
• Tribal Group

Activate a partner topic

1. In the search bar of the Azure portal, search for and selectEvent Grid Partner Topics.

2. On theEvent Grid Partner Topics page, select the partner topic in the list.

   

3. Review the activate message, and selectActivate on the page or on the command bar to activate the partner topic before the expiration time mentioned on the page.

   

4. Confirm that the activation status is set toActivated and then create event subscriptions for the partner topic by selecting+ Event Subscription on the command bar.

   

Subscribe to events

First, create an event handler that handles events from the partner. For example, create an event hub, Service Bus queue or topic, or an Azure function. Then, create an event subscription for the partner topic using the event handler you created.

Create an event handler

To test your partner topic, you'll need an event handler. Go to your Azure subscription and spin up a service that's supported as anevent handler such as anAzure Function. For an example, seeEvent Grid Viewer sample that you can use as an event handler via webhooks.

Subscribe to the partner topic

Subscribing to the partner topic tells Event Grid where you want your partner events to be delivered.

1. In the Azure portal, typeEvent Grid Partner Topics in the search box, and selectEvent Grid Partner Topics.

2. On theEvent Grid Partner Topics page, select the partner topic in the list.

   

3. On theEvent Grid Partner Topic page for the partner topic, select+ Event Subscription on the command bar.

   

4. On theCreate Event Subscription page, do the following steps:

   1. Enter aname for the event subscription.

   2. ForFilter to Event Types, select types of events that your subscription receives.

   3. ForEndpoint Type, select an Azure service (Azure Function, Storage Queues, Event Hubs, Service Bus Queue, Service Bus Topic, Hybrid Connections. etc.), or webhook.

   4. Select theConfigure an endpoint link. In this example, let's use Azure Event Hubs destination or endpoint.

      

   5. On theSelect Event Hub page, select configurations for the endpoint, and then selectConfirm Selection.

      

   6. Now on theCreate Event Subscription page, selectCreate.

      

Related content

For more information, see the following articles about the Partner Events feature:

• Partner Events overview for customers
• Partner Events overview for partners
• Onboard as a partner