Skip to main content
MultiBaas webhooks deliver real-time HTTP POST callbacks to your server whenever a configured on-chain event fires. This lets you react to contract activity without polling the blockchain.

Supported Event Types

Creating a Webhook

In the Dashboard

  1. Go to Blockchain → Webhooks → +
  2. Enter a label and your publicly accessible HTTPS endpoint URL
  3. Save

Via API

Webhook Payload

Each request delivers a JSON array of one or more events:

Verifying Signatures

Every webhook request includes two headers:
  • X-MultiBaas-Signature — HMAC-SHA256 of the raw request body concatenated with the timestamp
  • X-MultiBaas-Timestamp — Unix timestamp as a string
Always verify the signature before processing an event to confirm the request originated from MultiBaas.
The webhook secret is shown once when you create the webhook in the MultiBaas dashboard.

Example: Next.js Webhook Handler

The following is based on how Celo Mondo uses MultiBaas webhooks to process Celo governance events in real time.
For a full production example — including governance proposal processing, multisig approval handling, progressive historical backfill, and database integration — see the Celo Mondo webhook handler.

Environment Variables