Platform
Inbound Parse Webhook
Learn how to process incoming emails for a domain or subdomain
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
- 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, useeu.inbound-mail.novu.co
- 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.
- 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.
Was this page helpful?