Subscribe to data ingestion events

In this lesson, you will subscribe to data ingestion events by setting up a webhook with the Adobe 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 you need to complete this lesson, specifically:

  • Developer-role access to the Luma Tutorial Platform product profile (for API)
IMPORTANT

These notifications triggered by the data ingestion events will apply to all of your sandboxes, not just the Luma Tutorial sandbox we are using for the exercises in this tutorial. So, you might see notifications coming from other data ingestion events in your other sandboxes.

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):

  1. In another browser tab, open the website https://webhook.site/

  2. You will be assigned a unique URL, which you should bookmark, as you will need to come back to it later in the data ingestion lessons:

    Webhook.site

  3. Click the Edit button in the top navigation

  4. As the Response body, enter $request.query.challenge$. The Adobe I/O Events notifications we will set up later in this lesson send a challenge to the webhook, and requires that it be included in the response body.

  5. Click the Save button

    Edit the response

Set up

  1. In another browser tab, open the Adobe Developer Console

  2. Open your Luma Tutorial API Project

  3. Click the Add to Project button and then select Event

    Add Event

  4. Filter the list by clicking Experience Platform

  5. Click to select Platform notifications

  6. Click the Next button
    Add the notifications

  7. Click to select all of the events

  8. Click the Next button
    Select the subscriptions

  9. On the next screen for configuring credentials, just click the Next button again
    Skip the credential screen

  10. As the Event registration name, enter Platform notifications

  11. Scroll down and click to open the Webhook section

  12. As the Webhook URL, paste the value from the Your unique URL field from webhook.site

  13. Click the Save configured events button
    Save the events

  14. 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
    Configuration saved

  15. 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:
    First request in webhook.site

That’s it for now, you will learn more about these notifications in the next lessons when you ingest data.

Additional Resources

Ok, let’s finally start ingesting data!

On this page