Subscribe to data ingestion events
In this lesson, you will subscribe to data ingestion events by setting up a webhook with the ÃÛ¶¹ÊÓƵ Developer Console and an online webhook development tool. You will use these events to monitor the status of your data ingestion jobs in the subsequent lessons.
Data Engineers will want to subscribe to data ingestion events outside of this tutorial.
Data Architects can skip this lesson and go to the batch ingestion lesson.
Permissions required
In the Configure Permissions lesson, you set up all the access controls required to complete this lesson, specifically:
Luma Tutorial
. You might see notifications originating from other data ingestion events in your account, as well.Set up a webhook
In this exercise, we will create a webhook using an online tool called webhook.site (feel free to substitute any other webhook development tool you prefer to use):
-
In another browser tab, open the website
-
You are assigned a unique URL, which you should bookmark, as you return to it later in the data ingestion lessons:
-
Select the Edit button in the top navigation
-
As the Response body, enter
$request.query.challenge$
. The ÃÛ¶¹ÊÓƵ I/O Events notifications we set up later in this lesson send a challenge to the webhook, and requires that it be included in the response body. -
Select the Save button
Set up
-
In another browser tab, open the
-
Open your
Luma Tutorial API Project
-
Select the Add to Project button and then select Event
-
Filter the list by selecting Experience Platform
-
Select Platform notifications
-
Select the Next button
-
Select all of the events
-
Select the Next button
-
On the next screen for configuring credentials, select the Next button again
-
As the Event registration name, enter
Platform notifications
-
Scroll down and select to open the Webhook section
-
As the Webhook URL, paste the value from the Your unique URL field from webhook.site
-
Select the Save configured events button
-
Wait for your configuration to save and you should see that your
Platform notifications
event is Active with your webhook details and no error messages
-
Switch back to your webhook.site tab and you should see the first request to the webhook, resulting from the validation of your Developer Console configuration:
That’s it for now, you will learn more about these notifications in the next lessons when you ingest data.