FAQ: Webhook Channels

With JumpCloud's Webhook Notification Channels,  you can add specific URLs to define who you want to notify regarding critical alerts and and their related events. This is a list of frequently asked asked questions related to Webhook Channels.

What are webhooks in JumpCloud used for?

Webhooks allow you to receive real-time notifications when specific events occur in JumpCloud, such as alerts and selected DI events. They help integrate JumpCloud with external systems like SIEMs, ticketing tools, or automation platforms.

What types of events can trigger a webhook?

Webhooks can be triggered by:

  • Alert notifications (e.g., low disk space, unauthorized software, etc.)
  • Directory Insights events
  • Access Management events 
What HTTP methods are supported for webhooks?

JumpCloud webhooks use the POST method to send event data in JSON format to the configured URL.

How do I secure sensitive values in headers or URLs?

While setting up the channel, you can:

  • Mask sensitive header values using the “Sensitive Value” toggle.
  • Protect tokens in the webhook URL (e.g., https://api.example.com/hook/{{TOKEN}}) — these values are encrypted and not retrievable after saving.

See Create Webhook Channel to learn more.

Can I send different headers with each webhook request?

Yes. You can configure multiple static headers per webhook channel. Some can be marked as sensitive (like API keys).

What happens if my webhook endpoint is temporarily down?

JumpCloud retries webhook delivery three times with exponential backoff for HTTP status codes 5xx, 408, or 429.

How can I test my webhook configuration?

After configuring a webhook channel, you can send a test event from the UI to validate connectivity.

Are webhook payloads customizable?

At this time, payloads follow a fixed JSON schema per event type. Future enhancements may support custom field mapping or transformations.

How do I know if a webhook failed?

Failures are logged in the Directory Insights.

Can I use the same webhook channel across multiple rules or services?

Yes. Webhook channels are reusable and can be linked to multiple alert rules or other services within the platform.

Back to Top

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case