Send Webhooks Overview

Learn how to use the Hookdeck event gateway to securely and reliably send outbound webhooks.

If you're building a developer platform or a SaaS, your customers may want to be programmatically notified when events occur in your platform.

Outbound webhook infrastructure

The most ubiquitous notification mechanism is via webhooks, an outbound HTTP request to a URL that your customer provides Hookdeck provides infrastructure and functionality that enables you to configure and securely and reliably send webhooks to your customers.

Via the Hookdeck API you can expose the following functionality to your customers:

  • Register webhook URLs
  • Filter events by payload and header
  • Transform event payloads and headers
  • Set configurable retry policies
  • Provide flexible authentication mechanisms
  • Display registered webhooks
  • Display webhook history and delivery status

💡 Try the outbound webhook quickstart to get started.

How to use Hookdeck for outbound webhooks

This guide provides a common approach to using Hookdeck for outbound webhooks. It assumes that you will provide a UI for registering webhook URLs within your platform's dashboard and that your platform has the concept of an account.

This guide covers a core subset of potential functionality:

  1. How to map Hookdeck Connections, Sources, and Destinations to your platform's accounts
  2. Signing webhooks
  3. Sending webhooks
  4. Retrieving registered webhooks
  5. Displaying webhook history and delivery status