Skip to main content
Webhooks notify another service when selected project activity occurs. Use Studio for setup and delivery monitoring. Use the CLI webhook reference for event names, payload variables, and signature verification.

​
Add a webhook

Open Project settings, choose Webhooks, then add a webhook.
1

Choose the event

Select the project activity that should create a delivery. Event-specific filters appear with the event.
2

Set the destination

Enter the HTTPS endpoint that should receive the request.
3

Choose the payload

Send the complete Fimo event, or create a custom JSON body from the variables Studio shows for that event.
4

Test the delivery

Send a test, then inspect its status and response before depending on the webhook.

​
Add destination headers

Add the headers required by the destination. Use a project secret for private values instead of placing them directly in a payload. Fimo signs webhook requests by default. Save the signing secret when Studio shows it, then follow Verify signed requests in your receiver.

​
Inspect deliveries

Open a webhook to see recent delivery attempts and their status. A failed delivery may become available for manual retry after automatic retries finish.
A successful test confirms the configured destination accepted the example request. Test again after changing the URL, headers, event, or payload.

​
What’s next

Webhook reference

See event discovery, CLI commands, payload rules, and signatures.

Automate your project

Compare webhooks with agents, schedules, and chat.