Webhooks

The Webhooks setting in Jamf Pro allows you to create outbound webhooks for any event in the Events API. In conjunction with the Events API, webhooks allow you to use real-time events from Jamf Pro to build custom workflows on-demand using the programming language of your choice. For example, you could configure a webhook to send an event to an instant message plug-in you have written that will notify a chatroom when a third-party macOS software title in Jamf Pro has been updated.

Configuring a Webhook

  1. In Jamf Pro, click Settings in the top-right corner of the page.
  2. In the Global Management section, click Webhooks .
  3. Click New .
  4. Enter a display name for the webhook.
  5. Enter a URL for the webhook to post to.
  6. Choose the type of authentication required to connect to the webhook:

    • None—Requires no additional information.

    • Basic Authentication—Requires username and password information.

    • Header Authentication—Requires key value pairs in JSON format similar to the following:

       {"Authorization":"Value", "Token":"TokenValue"}
      Note:

      The following keys are not allowed in the Header Authentication field:

      • Content-Type

      • User-Agent

      • Accept-Encoding

      • Content-Length

      • Host

  7. Enter the connection timeout for the webhook.
  8. Enter the read timeout for the webhook.
  9. Choose either "XML" or "JSON" as the format for sending the webhook information.
  10. Choose the event that will trigger the webhook.
  11. Click Save .

For information on supported webhooks, see the Jamf developer resources: 
https://developer.jamf.com/developer-guide/docs/webhooks