Skip to main content

Documentation Index

Fetch the complete documentation index at: https://v0.x-docs.novu.co/llms.txt

Use this file to discover all available pages before exploring further.

Inbound Webhook is a feature that allows processing of incoming emails for a domain or subdomain. The feature parses contents of an email and POSTs the information to a specified URL in a multipart/form-data format.
This feature is available only in Novu cloud. This feature will not work in community self hosted version and local environment.

​
Steps to set up Inbound Webhook

  1. Set up an MX Record:
    • Log in to your domain host’s website and navigate to the MX Records page.
    • Create a new MX record for the subdomain you want to process incoming email (e.g. reply.yourdomain.com).
    You must create a new record for this as this feature does not work if the MX record is already set on the domain. Here is an example with route 53
    • Assign the MX record a priority of 10 and point it to the specified inbound mail server that located on the admin dashboard on the Email Settings.
      For US, use inbound-mail.novu.co and For EU, use eu.inbound-mail.novu.co
  2. Add Domain to allowed list:
    • Log in to the dashboard.
    • Go to the Setting tab in the left vertical navbar.
    • Navigate to Email Settings on the settings page.
    • Add your domain to the allowed domain box.
    You can only add one Inbound Webhook domain per organization.
  3. Enable Inbound Parse and Set Webhook URL:
    • Log in to the dashboard.
    • Navigate to the Workflow Editor.
    • Select the email step.
    • Enable the Inbound Parse feature.
    • Set the Webhook URL to the location where you want the parsed data to be POSTed.
The Webhook URL must be publicly accessible without authentication.