Email Webhook Email Integration with Novu

Email Webhook lets Novu hand each email payload to an HTTP endpoint you control. Instead of calling a built-in ESP SDK, Novu POSTs the rendered message to your Webhook URL and signs the body with your HMAC secret.

Use this when you want Novu workflows and templates, but delivery goes through an internal service or a provider that is not listed in the Integrations Store.

Creating an Email Webhook integration with Novu

1. Visit the Integrations page on Novu.
2. Click Add a provider.
3. Locate Email Webhook under the Email section and click Connect.
4. Enter your:
   • Webhook URL (HTTPS endpoint that accepts POST JSON)
   • Secret Hmac Key (used to sign each request)
   • From email address
   • Sender name
5. Confirm Active Integration is on. New integrations start active by default.
6. Click Create Integration.

Request format

For each email, Novu sends a POST request to your webhook URL with:

• Content-Type: application/json
• X-Novu-Signature: <hmac-sha256-hex> of the raw JSON body, using your Secret Hmac Key

Verify the signature before processing the payload. Reject requests that do not match.

The JSON body includes the rendered email fields Novu already prepared for the subscriber (to, from, subject, html/text content, and related metadata).

<Note> Email Webhook is marked beta in Novu. Treat it as a custom delivery bridge and monitor your endpoint health. </Note>

Next Steps

<Columns cols={2}> <Card title="Configure bcc, cc, and reply-to" href="/platform/integrations/email#sending-email-overrides"> Learn how to configure bcc, cc, and reply-to for your email notifications using email overrides </Card> <Card title="Sending email attachments" href="/platform/integrations/email#sending-email-attachments"> Learn how to send attachments with email notifications </Card> <Card title="Use different email integration" href="/platform/integrations/email#sending-email-overrides"> Learn how to use different email provider integrations to be used to send emails </Card> </Columns>