How do webhooks and integrations work?

Webhooks let you automatically forward events from your Selfbase page to an external service — a Slack channel, a Notion database, a CRM, or your own backend.

Setting up a webhook

1. Open Settings → Integrations on your page
2. Tap Add webhook
3. Enter the destination URL and choose which events to listen for
4. Save — Selfbase will send a POST request to that URL each time the event fires

Event types

• form_submission — fires when someone submits a Form block on your page
• email_capture — fires when someone enters their email through an email gate
• purchase — fires when someone completes a payment (Tip Jar or Product Sale)

Webhook payload

Each request is a JSON POST with the event type, page details, and the relevant data (e.g. submitted form fields, captured email address, or purchase amount).

Security

Every webhook request includes an X-Selfbase-Signature header with an HMAC-SHA256 signature. You can use this to verify that the request genuinely came from Selfbase. Your webhook secret is shown once when you create the webhook — store it securely.

Testing

Use the Send test button on any webhook to fire a sample payload to your endpoint. This is useful for verifying your endpoint is reachable and handling the data correctly before going live.

Good to know

• Webhooks are available on all plans
• Web3Forms block submissions are not forwarded to webhooks — use the Form block if you need webhook support for form submissions
• You can have multiple webhooks per page, each listening to different events