# Import Bulk Emails with Headers

**URL:** <https://community.hubspot.com/t/import-bulk-emails-with-headers/120505>\
**Category:** APIs & Integrations\
**Tags:** email, contacts\
**Created:** [November 14, 2024, 2:08pm UTC](https://community.hubspot.com/t/import-bulk-emails-with-headers/120505 "2024-11-14T14:08:02Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![justinrea](https://avatars.discourse-cdn.com/v4/letter/j/9de053/32.png) [@justinrea](https://community.hubspot.com/u/justinrea)\
**Post date:** [November 14, 2024, 2:08pm UTC](https://community.hubspot.com/t/import-bulk-emails-with-headers/120505/1 "2024-11-14T14:08:02Z")

</div>

What is the best approach to importing ~500K emails to contacts and **include** the email headers? I can’t seem to find a column that works for email headers with the CSV import process. The API could take several hours to import that many emails.

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [November 15, 2024, 12:10pm UTC](https://community.hubspot.com/t/import-bulk-emails-with-headers/120505/2 "2024-11-15T12:10:50Z")

</div>

Hi @justinrea and welcome to the Community, we are so glad to have you here!  
Thanks for reaching out to the Community!  
I’d like to share these resources for information:  
- [Imports](https://developers.hubspot.com/beta-docs/guides/api/crm/imports)  
- [Engagements (email)](https://developers.hubspot.com/beta-docs/guides/api/crm/engagements/email)  
I also wanted to invite a couple of subject matter experts to this conversation: Hi @Bortami, [@HubSpot\_Corey](https://community.hubspot.com/t5/user/viewprofilepage/user-id/580930) and @Teun have you already succeeded to import email headers into HubSpot to help @justinrea, please? If not, do you have a workaround maybe?  
Thanks so much and have a lovely weekend!  
Best,  
Bérangère

---

<div class="post-metadata">

**Author:** ![Bortami](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/bortami/32/221350_2.png) [@Bortami](https://community.hubspot.com/u/Bortami)\
**Post date:** [November 15, 2024, 6:44pm UTC](https://community.hubspot.com/t/import-bulk-emails-with-headers/120505/3 "2024-11-15T18:44:44Z")

</div>

Are you talking about contact email address, 1 on 1 emails sent to contacts, or marketing emails?

If talking sales emails as in the email engagement object, I would do this via the [CRM import](https://developers.hubspot.com/beta-docs/guides/api/crm/imports) endpoint. The import endpoint lets you process more data but there is more work to format the JSON file needed. Individual import files are limited to 1,048,576 rows or 512 MB.

“hs\_email\_header” is the header field you would write to via the API. ([Here’s a list of the writable properties](https://developers.hubspot.com/beta-docs/guides/api/crm/engagements/email#properties))