Skip to main content

Email Providers

Courier integrates with many different email providers, as well as SMTP. In order for a recipient to receive an email notification, their user profile must include an email address in the email property.

// Recipient Profile
{
"email": "support@courier.com"
}
tip

Can't find a provider? Send us a chat ↘️ or email support@courier.com

Email channel override

Use the email channel override property to override channel settings such as subject, reply to, from, cc, and bcc email addresses, along with HTML and text content. These overrides will apply to all your email channels within a template.

note

Attachment overrides at the channel level are currently supported for Mailgun, Postmark, AWS SES, and Amply. For adding attachment overrides through other email providers, refer to the override section in the respective provider documentation.

Data structure for the email channel override:

{
"message": {
// ...rest of request
"channels": {
"email": {
"override": {
"attachments": [],
"bcc": "",
"brand": {},
"cc": "",
"from": "",
"html": "",
"reply_to": "",
"subject": "",
"text": "",
"tracking": {
"open": false
}
}
}
}
}
}

Brand override

The channels.email.override.brand property uses same schema as the API request payload for the POST /brands endpoint.

Brand elements that can be overridden:

  • logo
  • top bar color
  • brand colors

Example:

{
"message": {
// ...rest of request
"channels": {
"email": {
"override": {
"brand": {
"settings": {
"email": {
"header": {
"logo": {
"image": "https://www.courier.com/logo.png",
"href": "https://www.courier.com"
},
"barColor": "#674ea7"
}
}
}
}
}
}
}
}
}

Allowlist for AWS IP Addresses

Some email providers, such as Mailgun, offer additional security to allowlist IP addresses to access their API. Courier is hosted on AWS and does not provide an IP range in the form of an allowlist.

As a workaround, users can subscribe to the AmazonIpSpaceChanged topic, and receive notifications about any changes to the AWS IP address ranges. For details, refer to the AWS documentation.

Was this helpful?