Skip to main content
White-labeling lets you send emails that appear to come from your customerā€™s domain. This involves two parts:
  1. Using your customerā€™s email service provider
  2. Sending from your customerā€™s email domain

ā€‹
Prerequisites

  • An email provider integration configured in your Courier workspace (e.g., Mailgun, SendGrid, Postmark)
  • Your customerā€™s email provider API key
  • Your customerā€™s verified sender domain on their provider

ā€‹
Set Up Email Service Provider Integrations

  1. Add an integration in your Courier workspace for each email provider you want to support
  2. Add those integrations to the email channel of the notification template you want to white-label
The initial API keys for these integrations donā€™t need to be valid if you always override them via the Send API.

ā€‹
Configure Provider Selection

Use provider-level conditions to determine which provider to use. For example, pass a provider field in your data object and set a condition that enables a specific provider only when that value matches.

ā€‹
Override the API Key

When sending an email, provide your customerā€™s API key using the providers override: 
{
  "message": {
    "to": {
      "email": "recipient@example.com"
    },
    "template": "white-label-welcome",
    "data": {
      "customer_name": "Acme Corp"
    },
    "providers": {
      "mailgun": {
        "override": {
          "config": {
            "apiKey": "CUSTOMER_MAILGUN_API_KEY"
          }
        }
      }
    }
  }
}

ā€‹
Set the ā€˜Fromā€™ Email Address

To send from your customerā€™s email address:
  1. Use a variable in the email channel settings for the From field (e.g., {customer_from_email})
  2. Pass that variable in the data object when sending
For more details, see Customizing Email Address Fields.

Email Address Fields

Customize From, Reply-To, CC, and BCC per notification

Brands Overview

Configure visual branding for white-labeled notifications