Skip to main content

Managing webhooks

Webhooks send near real-time account events to an HTTPS endpoint that you operate.

Create an endpoint​

  1. Select New webhook.
  2. Enter a public HTTPS URL.
  3. Add a short description so teammates know which system owns the endpoint.
  4. Select only the event subscriptions that system needs.
  5. Save the webhook and copy its signing secret when it is shown.

Store the secret in your server-side secret manager. ValueMapper signs deliveries so your receiver can verify that a request is authentic.

Maintain an endpoint​

The webhook list shows whether an endpoint is enabled and which events it receives. From the row actions you can edit the URL or subscriptions, rotate the signing secret, enable or disable delivery, and delete the endpoint.

Rotating a secret invalidates the old value. Coordinate the change with the receiving service to avoid failed verification.

Check deliveries​

Use Recent deliveries to diagnose response status and timing. A successful HTTP response only confirms receipt; your service should also process events idempotently because retries can occur.

warning

Disabling or deleting a webhook stops future deliveries. It does not replay events that the destination missed.

For payloads, event names, and signature implementation, see Managing webhooks with the API.