# Email Custom Headers created via API

**URL:** <https://forum.mautic.org/t/email-custom-headers-created-via-api/34401>\
**Category:** Product Support\
**Created:** [December 10, 2024, 10:23pm UTC](https://forum.mautic.org/t/email-custom-headers-created-via-api/34401 "2024-12-10T22:23:31Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![paul.piazza.pro](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/paul.piazza.pro/32/13297_2.png) [@paul.piazza.pro](https://forum.mautic.org/u/paul.piazza.pro)\
**Post date:** [December 10, 2024, 10:23pm UTC](https://forum.mautic.org/t/email-custom-headers-created-via-api/34401/1 "2024-12-10T22:23:31Z")

</div>

**Your software**  
My Mautic version is: 4  
My PHP version is: 7  
My Database type and version is:

**Your problem**

My problem is: how I can manage custom headers of an email template through the API?

I use POST api/emails/new and add input headers in the json.

“Headers”: [  
{  
“My-custom-header”: “email code”  
}  
]

I received error code 400 headers: this form should not contain extra fields.

---

<div class="post-metadata">

**Author:** ![spikedcola](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/spikedcola/32/14784_2.png) [@spikedcola](https://forum.mautic.org/u/spikedcola)\
**Post date:** [May 6, 2026, 6:44pm UTC](https://forum.mautic.org/t/email-custom-headers-created-via-api/34401/2 "2026-05-06T18:44:17Z")

</div>

For anyone else who has the same problem and finds this, the correct format is:

```auto
$email['headers'] = [
	'list' => [
		[
			'label' => 'X-Header-XYZ',
			'value' => 'value'
		]
	]
];

```