Configure a Custom Email Provider

You can set up any email provider using the Custom Email Provider option. It leverages our Actions Code Editor to give you full control of the email delivery process.

Configure Custom Email Provider

  1. Go to Auth0 Dashboard > Branding > Email Provider.

  2. Enable the Use my own email provider toggle.

  3. In the Email Provider Section, select Custom Provider.

  4. Click the + button next to Custom Email Provider to open the Actions Code Editor.

  5. In the Actions Code Editor Window, add the appropriate code to deliver messages to your provider:

    1. Consult with your provider's documentation to understand how to deliver messages to their API.

    2. Add any required secrets to authenticate with the API.

    3. Like other Actions, use the Management API to manage the Action and its versions.

  6. Deploy your action by clicking the Deploy button in the top right corner of the page.

  7. Navigate back by clicking Back to Email Provider in the top left corner. You should see a green check and Enabled in the Provider Configuration section.

  8. Finalize your custom provider by clicking Save.

  9. Make sure to test your configuration by sending a test email using the Send Test Email button.

Use Cases

While the primary use case is to deliver messages to providers that are not supported by the default email options, other use cases include:

  • Retrying failures

  • Changing recipient(s)

  • Changing message payload

  • Creating Organization-specific logic

Remove the Action

The Custom Email Provider option on Auth0 Dashboard > Branding > Email Provider must be disabled before the Action can be deleted in order to prevent accidental email delivery failures.