Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.babysea.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

RoleCan viewCan create/updateCan rotate secretCan replay or deliver queued eventsCan delete
primary-ownerYesYesYesYesYes
ownerYesYesYesYesYes
memberYesNoNoNoNo
Members can inspect endpoint metadata and delivery logs, but management actions are disabled.

What you manage

AreaDescription
Endpoint URLPublic HTTPS URL on the default HTTPS port that receives POST requests.
EventsSubscribed event types, including generation.completed and credits.low_balance.
Signing secretwhsec_... secret used to verify X-BabySea-Signature.
Delivery logEvent type, generation ID, payload, status code, error, attempts, and timestamp.
QueuePending generation events that arrived while the endpoint was disabled.

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.
https://api.example.com/webhooks/babysea
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:
ColumnDescription
EventEvent type, such as generation.completed.
Generation IDRelated generation ID, when the event is generation-specific.
PayloadJSON body sent to your endpoint.
Status codeHTTP status returned by your endpoint.
ErrorDelivery error or non-2xx status summary.
AttemptsNumber of attempts recorded for the delivery.
TimestampDelivery log timestamp.

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.