Automate email notifications by configuring an organizational webhook in ArcGIS Enterprise using Microsoft Power Automate

Summary

Organization webhooks can be configured to listen for events on items, users, groups, and roles. An example of this is a webhook configured to trigger when a specific user signs in to the Enterprise portal or when any item has been added to the ArcGIS Enterprise portal. 

Prerequisites:

• To use organization webhooks, the organization must be using ArcGIS Enterprise 10.7 or later.
• To create and manage organization webhooks, you must either be assigned the Organization webhooks privilege or be assigned the default administrator role.

Procedure

The ArcGIS Enterprise connector only works with feature service events or ArcGIS Suvey123 events and not with organization events, however Microsoft Power Automate (formerly Microsoft Flow) offers a webhook connector that can be used to build this workflow.

Create a new flow to trigger a webhook when an item has been added to the ArcGIS Enterprise portal.

1. In Power Automate, click + Create.
2. Choose Automated cloud flow.
3. Click Skip.
4. Click the Add a trigger button.
5. From the search bar under the Add a trigger section, enter http.
6. From the Triggers section, under Request, choose When an HTTP request is received.
7. Copy the Payload example for Organizational webhooks from the web help page, make the changes as per your requirements, and paste it into the Request Body JSON Schema section, as shown in the next image.

7. Below the When an HTTP request is received card, click New step  to open the Add an action pane.
8. In the Add an action pane, in the search bar, type Send an email (V2). Under Office 365 Outlook, select Send an email (V2).
9. In the Send an email (V2) pane, on the Parameters tab, configure the parameters as follows:
   • For To, specify the desired email address.
   • For Subject, specify the desired subject of the email. You can use the dynamic content option to select the parameters from the JSON Data configured in the previous step.
   • Similarly, for Body, specify the desired body content of the email.

10. In the My Flows page, click Save .
11. Click the When an HTTP request is received dialog to copy the URL generated from the HTTP URL parameter using the copy (paper) icon.

Configure the webhook in ArcGIS Enterprise

1. Sign in to your organization as a default administrator or a member of a custom role with the Organization webhooks privilege.
2. Browse to Organization > Settings > Webhooks.
3. Under Organization webhooks, click Create webhook.
4. In the Create webhook window, do the following:
• Provide a unique name for the webhook in the Name text box.
• Select Items from the Type drop-down menu.
• Select an event trigger from the Events drop-down menu. In this case: /items/add.
• In the Webhook receiver URL, provide the payload URL for the webhook receiver copied in step 11, above.

5. Click Create webhook.

The image below shows the automated email notification generated in Microsoft Office 365 Outlook whenever the configured event is triggered on the Item:

Note:
Creating or editing a webhook fails when using Microsoft’s Power Automate as a receiver for ArcGIS Enterprise (10.7.1 to 12.0) organization webhooks due to BUG-000179555. This is because of the recent change in the character limit of the payload URL generated from the Microsoft Power Automate; this has been fixed in ArcGIS Enterprise 12.1.