Subscribe to events published by a partner with Azure Event Grid

This article describes how to subscribe to events from a system owned or managed by a partner, such as SaaS or Enterprise Resource Planning (ERP) platforms.

High-level steps

Follow these steps 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 used Event Grid before, you need to register the Event Grid resource provider. If you used Event Grid before, skip to the next section.

In the Azure portal, follow these steps:

1. On the left menu, select Subscriptions.

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

3. On the Subscription page, under Settings on the left menu, select Resource providers.

4. Search for Microsoft.EventGrid, and confirm that the Status is NotRegistered.

5. Select Microsoft.EventGrid in the provider list.

6. On the command bar, select Register.

   

7. Refresh to make sure the status of Microsoft.EventGrid changed to Registered.

   

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.

The following example shows how to create a partner configuration resource that contains the partner authorization. You identify the partner by providing either its partner registration ID or the partner name. You can get both from your partner, but only one is required. For your convenience, the following examples include a sample expiration time in UTC format.

Azure portal

1. Sign in to the Azure portal.

2. In the search bar at the top, enter Partner Configurations, and select Event Grid Partner Configurations under Services in the results.

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

   

4. On the Create Partner Configuration page, follow these steps:

   1. In the Project Details section, select the Azure subscription and the resource group where you want to allow the partner to create a partner topic.

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

   3. To authorize a partner to create partner topics in the specified resource group, select the + Partner Authorization link.

      

5. On the Add partner authorization to create resources page, you see a list of verified partners. A verified partner is a partner whose identity Microsoft validated. Select a verified partner, and then select Add 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 a non-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 work only with verified partners. If the partner isn't yet verified, encourage them to get verified by contacting the Event Grid team at askgrid@microsoft.com.

   1. To authorize a verified partner:

      1. Select the partner from the list.

      2. Specify authorization expiration time.

      3. select Add.

         

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

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

      2. Specify authorization expiration time.

      3. Select Add.

         

         Important

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

6. Back on the Create Partner Configuration page, verify that the partner appears in the partner authorization list.

7. Select Review + create.

   

8. On the Review page, review all settings, and then select Create to create the partner registration.

Request partner to enable events flow to a partner topic

The following partners support events flow to a partner topic. Select a partner to submit a request.

• Auth0
• Microsoft Graph API
• Tribal Group

Activate a partner topic

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

2. On the Event Grid Partner Topics page, select a partner topic with Activation State set to Never Activated.

   

3. Review the activate message, and select Activate 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 to Activated 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 by using the event handler you created.

Create an event handler

To test your partner topic, you need an event handler. Go to your Azure subscription and create a service that's supported as an event handler such as an Azure Function. For an example, see the Event Grid Viewer sample that you can use as an event handler through 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, in the search box, enter Event Grid Partner Topics, and then select Event Grid Partner Topics.

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

   

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

   

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

   1. Enter a name for the event subscription.

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

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

   4. Select the Configure an endpoint link. This example uses an Azure Event Hubs destination.

      

   5. On the Select Event Hub page, select configurations for the endpoint, and then select Confirm Selection.

      

   6. Now on the Create Event Subscription page, select Create.

      

Related content

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

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