Skip to main content
Webhooks let your server receive signed BabySea events without polling. Use this dashboard page to manage endpoints and delivery history.

Webhook integration guide

Verify signatures, inspect payloads, and review delivery behavior.

​
Access

Members can inspect endpoint metadata and delivery logs, but management actions are disabled.

​
What you manage

​
Create an endpoint

1

Open Webhook

From the dashboard, open Webhook.
2

Add endpoint

Enter a publicly reachable HTTPS URL on the default HTTPS port that accepts POST requests without redirecting.
3

Choose events

Subscribe to the event types your server handles.
4

Store the secret

Copy the whsec_... signing secret before closing the dialog. It cannot be retrieved later.
5

Send a test event

Open the endpoint details page and click Send test event. Your handler should return any 2xx status.

​
Endpoint details

Owners can use the endpoint details page to:
  • enable or disable the endpoint
  • rotate the webhook secret
  • send a test event
  • replay an individual delivery
  • deliver queued events
  • delete the endpoint
Use webhooks for the raw-body verification flow before processing event data.

​
Delivery log

The delivery table shows:

​
Queued events

If all retry attempts fail repeatedly, BabySea can disable the endpoint. Matching generation events that arrive while an endpoint is disabled are queued for later delivery. Use Deliver queued events after fixing the endpoint and re-enabling it. See webhook delivery behavior for retry, timeout, auto-disable, and queue details.