# How to add custom headers to emails?

**URL:** <https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431>\
**Category:** Get Help\
**Tags:** smtp, email\
**Created:** [December 20, 2019, 7:51pm UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431 "2019-12-20T19:51:26Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![laurent1](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/laurent1/32/14673_2.png) [@laurent1](https://community.auth0.com/u/laurent1)\
**Post date:** [December 20, 2019, 7:51pm UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/1 "2019-12-20T19:51:26Z")

</div>

Is it possible to add custom message headers to email sent by Auth0 using our configured SMTP provider?

I’m not seeing anything in the SMTP provider configuration, or in the email templates section either…

Thanks

---

<div class="post-metadata">

**Author:** ![ashish](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/ashish/32/7056_2.png) [@ashish](https://community.auth0.com/u/ashish)\
**Post date:** [December 22, 2019, 10:52pm UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/2 "2019-12-22T22:52:04Z")

</div>

> [@laurent1](#):
>
> Is it possible to add custom message headers to email sent by Auth0 using our configured SMTP provider?

I’m afraid the answer is no. However I’m interested to know which headers you require and what problem you are trying to solve. Maybe there is another alternative?

---

<div class="post-metadata">

**Author:** ![laurent1](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/laurent1/32/14673_2.png) [@laurent1](https://community.auth0.com/u/laurent1)\
**Post date:** [January 23, 2020, 9:17pm UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/3 "2020-01-23T21:17:42Z")

</div>

Our email provider support “marketing” and “transactional” emails from being sent, and allow our users to opt-out of marketing email while still getting the transactional ones. By default emails are considered to be marketing and we need to include a custom header to mark it as transactional.

Without that, users don’t get any email coming from auth0… Workaround is to implement anything that uses email ourself (email verification, password reset, etc.), but this reduce the value we get from Auth0, so not good for you 😉

---

<div class="post-metadata">

**Author:** ![i\_zhamoidsin](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/i_zhamoidsin/32/13731_2.png) [@i\_zhamoidsin](https://community.auth0.com/u/i_zhamoidsin)\
**Post date:** [September 7, 2021, 11:18am UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/4 "2021-09-07T11:18:08Z")

</div>

+1 to the case  
We do use email performance tracking & reputation monitoring to measure email bounce, open & click rate. Having the possibility to add a custom header would allow us to break down email feedback data.

---

<div class="post-metadata">

**Author:** ![anderson.ku](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/anderson.ku/32/35544_2.png) [@anderson.ku](https://community.auth0.com/u/anderson.ku)\
**Post date:** [March 2, 2022, 4:36am UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/5 "2022-03-02T04:36:11Z")

</div>

+1  
Apologies for resurrecting this thread. We want to let SparkPost to use dedicated IP Pools (high reputation) to send Auth0 related emails.

E.g. ```  
X-MSYS-API: { “options”: { “ip\_pool”: “my\_new\_ip\_pool” } }

```auto
https://support.sparkpost.com/docs/deliverability/dedicated-ip-pools
```

---

<div class="post-metadata">

**Author:** ![charles3](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/charles3/32/36257_2.png) [@charles3](https://community.auth0.com/u/charles3)\
**Post date:** [March 30, 2022, 2:03pm UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/6 "2022-03-30T14:03:41Z")

</div>

Hi, we want this for Sendgrid integration as well.

The Sendgrid API allows us to define suppression groups when sending emails but Auth0 does not expose this option, so our transactional emails go to the same list as our promotional ones (and users often unsub to promotional emails, then get locked out of their accounts because they also unknowingly unsubbed to forgot password and 2fa emails).

The headers/API Options are described here:

> **[Suppression Groups](https://docs.sendgrid.com/for-developers/sending-email/suppressions#defining-asm-groups-to-display-on-the-manage-preferences-page)**
>
> Suppression groups allow you to set up unsubscribe lists and options

Any interest in surfacing this feature? Having Auth0 send our transactional emails through Sendgrid email Relay is great, but useless unless we can mark emails as transactional.

Definitely reduces the Auth0+Sendgrid value as we are now looking at sending the transactional emails ourselves.

Edit: Adding this to the SMTP custom integration would work for us too, we could switch from regular Sendgrid API to using the Sendgrip SMTP API.

Charles

---

<div class="post-metadata">

**Author:** ![emiel](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/emiel/32/33674_2.png) [@emiel](https://community.auth0.com/u/emiel)\
**Post date:** [July 6, 2022, 12:13pm UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/7 "2022-07-06T12:13:21Z")

</div>

Hi,

It seems we’re running into the same issues here. We’re using Mandrill as SMTP provider and I was looking into how to add the `List-Unsubscribe` header.

Your comment was very informative @charles3! We’re still getting notified by some of our end users still needing to check their junk folder for their _Change password_ mails.

FYI: the [Mail Tester](https://www.mail-tester.com/) site is very helpful for checking the quality of your e-mails.

Emiel

---

<div class="post-metadata">

**Author:** ![mgrover](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/mgrover/32/35982_2.png) [@mgrover](https://community.auth0.com/u/mgrover)\
**Post date:** [October 27, 2022, 9:14am UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/8 "2022-10-27T09:14:45Z")

</div>

Just to say that we’d also like this feature.  
We’re using AWS SES via the SMTP provider where we’re sending an email using an IAM user from one AWS account but using the email identity in another AWS account (this is common practice I believe to only have one account which has all the email setup). In order to do this, Amazon require you to set various headers to specify which resource to send the email as e.g. X-SES-SOURCE-ARN, X-SES-FROM-ARN etc. ([Sending emails for the identity owner for Amazon SES sending authorization - Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/dg/sending-authorization-delegate-sender-tasks-email.html#sending-authorization-delegate-sender-tasks-smtp))  
There is also no way I have seen in the Auth0 SES provider to specify the sending ARN so we cannot do it that way.

Thanks,

Matt

---

<div class="post-metadata">

**Author:** ![mgrover](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/mgrover/32/35982_2.png) [@mgrover](https://community.auth0.com/u/mgrover)\
**Post date:** [October 27, 2022, 9:50am UTC](https://community.auth0.com/t/how-to-add-custom-headers-to-emails/35431/9 "2022-10-27T09:50:37Z")

</div>

In case it helps anyone else, there is a feature of the Management API where you can set headers on emails except that the only header you can set (that I can see) is “X-SES-Configuration-Set” which does not solve my specific problem. [https://auth0.com/docs/api/management/v2#!/Emails/patch\_provider](https://auth0.com/docs/api/management/v2#!/Emails/patch_provider)
