Auth0 Extension: Auth0 Management API Webhooks

The Auth0 Management API Webhooks Extension allows you to use your own custom webhooks in conjunction with the Auth0 Management API. The extension will go through the audit logs and call the appropriate webhook if specific event(s) occur.

Configuring the Extension

To complete installation of this extension, click on the Auth0 Management API Webhooks box in the list of provided extensions on the Extensions page of the Management Portal. In the "Install Extension" window that then pops open, you will be asked to provide the following configuration variables:

  • Schedule: The frequency with which the webhook runs;
  • Auth0_Domain: The domain of your Auth0 app;
  • Auth0_Global_Client_ID: The Auth0 Global Client ID;
  • Auth0_Global_Client_Secret: The Auth0 Global Client Secret;
  • Auth0_API_Endpoints: The specific Auth0 Management API endpoints you want to monitor/call;
  • Webhook URL: The URL of your webhook;
  • Webhook_Concurrent_Calls: The maximum number of concurrent calls that will be made to your webhook.

Once you have provided the required pieces of information, click "Install" to finish installing the extension.

Using Your Installed Extension

You can view all scheduled jobs by clicking on the Auth0 Management API Webhooks line under the "Installed Extensions" tab.

Sample Payload

Here is an example of the payload that will be sent:


            "name":"John Doe",

How to Troubleshoot Webhooks

If your webhook isn't working, it can be difficult to troubleshoot and determine what is causing the issue. Webhooks are asynchronous, so testing them can involve you triggering the webhook, waiting, and then checking the response (assuming that you did receive a response).

However, there are certainly alternatives to the inefficient process we detailed above. While full details of how to troubleshoot a particular webhook is outside the scope of this article, here are some steps you can take to debug:

  1. Check the Logs section of the Dashboard for helpful messages.

  2. Analyze the requests your webhook is making using a tool like Hookbin or Mockbin.

  3. Mock requests using cURL or Postman

  4. Test your webhook code locally using something like localtunnel or ngrok

  5. Use a tool like Runscope or Assertible to watch the whole execution flow

Was this article helpful?