Prerequisites
Before creating a webhook, make sure you:- Have a BabySea account (personal or team).
- Are signed in to the dashboard.
- Have an owner-level role on the account. Members can view the page, but cannot create or manage endpoints.
- Have a public endpoint ready to receive
POSTrequests.
Step by step
Open Webhook
Navigate to Webhook in the sidebar. You will see a list of all registered endpoints for your account.
Click Add endpoint
Click Add endpoint in the top right corner. The dialog title is Add webhook endpoint.
Enter your URL
Enter the The current dashboard validates this field as a URL.
Endpoint URL value for your handler:Select events
In the
The manual event
Event types section, choose which generation events this endpoint should receive. All four are selected by default:| Checkbox label | Event value |
|---|---|
Generation Started | generation.started |
Generation Completed | generation.completed |
Generation Failed | generation.failed |
Generation Canceled | generation.canceled |
webhook.test is not part of this checkbox list. It is sent from Send test event on the details page.Store the webhook secret
After creation, BabySea opens the Webhook secret dialog and shows the secret once:The dialog includes
Show value, Hide value, a copy button, and Done.Store the secret as an environment variable. Never commit it to source code:.env
Send a test event
Open the new row to reach Webhook details, then click Send test event. BabySea sends a
webhook.test request with the fixed generation ID 00000000-0000-0000-0000-000000000000.Use this to verify:- Your endpoint is reachable over HTTPS.
- Your signature verification logic is working correctly.
- Your handler returns a
2xxresponse within 10 seconds.
What you see after creation
The webhook list page shows your new endpoint with:| Column | Description |
|---|---|
| Endpoint | Your endpoint URL. Click to open the details page |
| Status | Green Enabled badge or red Disabled badge |
| Created | Date the webhook was created |
| Actions | Menu with Delete |
Webhook details page
Click a webhook URL to open its details page. This page shows:| Section | What it contains |
|---|---|
| Endpoint URL | Your URL with a copy button |
| Status toggle | Switch to enable or disable the webhook |
| Events | Badges showing which events the endpoint receives |
| Webhook secret | The stored secret prefix followed by masked characters |
| Created | When the webhook was registered |
| Action buttons | Send test event, Rotate secret, Delete |
Implement your endpoint
Set up a handler that verifies the signature and acknowledges the delivery immediately. Process the payload asynchronously to stay within the 10-second response window.- Next.js
- Express
- Python
TypeScript