MultiConnectCloud › Database Deployments
12. Webhooks
A webhook sends a signed HTTPS POST to your URL when the database changes state. The one worth handling first is database.failover.started, which arrives before your connections drop.
| Event | When |
|---|---|
database.ready |
The database is ready |
database.failover.started, database.failover.completed, database.failover.failed |
A failover begins, finishes or fails |
database.readonly |
The database has stopped accepting writes |
database.replica.rebuilding, database.replica.ready, database.replica.lagging |
The second copy is being rebuilt, is ready, or is falling behind |
database.backup.completed, database.backup.failed |
A backup finished or failed |
database.restore.completed, database.restore.failed |
A restore finished or failed |
database.import.completed, database.import.failed |
An import finished or failed |
database.storage.warning |
Storage is running low |
To set it up, open your project on the dashboard, then the deployment, and use the Webhooks section: turn on Enable webhook, enter the Webhook URL and select Save. Reveal secret shows the signing secret, Send test event sends a test delivery and reports what your endpoint answered, and Event reference shows a sample body for each event.
Every delivery is signed with your secret. Verify the signature before trusting it. The Integration Guide on the deployment's page has verification examples in several languages.

