# Add Additional Email via API v3 - hs\_additional\_emails

**URL:** <https://community.hubspot.com/t/add-additional-email-via-api-v3-hs-additional-emails/129538>\
**Category:** APIs & Integrations\
**Tags:** contacts\
**Created:** [April 8, 2025, 10:49pm UTC](https://community.hubspot.com/t/add-additional-email-via-api-v3-hs-additional-emails/129538 "2025-04-08T22:49:18Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![PabloOsorio](https://avatars.discourse-cdn.com/v4/letter/p/c77e96/32.png) [@PabloOsorio](https://community.hubspot.com/u/PabloOsorio)\
**Post date:** [April 8, 2025, 10:49pm UTC](https://community.hubspot.com/t/add-additional-email-via-api-v3-hs-additional-emails/129538/1 "2025-04-08T22:49:18Z")

</div>

Hi. I see in previous posts that the only way to add secondary emails was to use the legacy v1 endpoint. However, I also see that there is some documentation of about using the property [hs\_additional\_emails in the current docs](https://developers.hubspot.com/docs/guides/api/crm/objects/contacts#secondary-emails).

However, trying to patch the contact with the property

hs\_additional\_emails fails with the following message.

```lia-code-sample
{
 "status": "error",
 "message": 'Property values were not valid: [{"isValid":false,"message":"\\"hs_additional_emails\\" is a calculated property; its value cannot be set.","error":"READ_ONLY_VALUE","name":"hs_additional_emails"}]',
 "correlationId": "9e699278-b9f1-4f14-a756-fdb2b6ffe03a",
 "errors": [
 {
 "message": '"hs_additional_emails" is a calculated property; its value cannot be set.',
 "code": "READ_ONLY_VALUE",
 "context": {"propertyName": ["hs_additional_emails"]},
 }
 ],
 "category": "VALIDATION_ERROR",
}

```

---

<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:** [April 9, 2025, 9:20am UTC](https://community.hubspot.com/t/add-additional-email-via-api-v3-hs-additional-emails/129538/2 "2025-04-09T09:20:09Z")

</div>

Hi @PabloOsorio and welcome, it’s a pleasure to have you here! 🤗  
Thanks for asking the HubSpot Community!  
I have found for you the solution from [@HubSpot\_Corey](https://community.hubspot.com/t5/user/viewprofilepage/user-id/580930) on this similar post “[Not possible to add secondary email in Contacts API Batch Upsert](https://community.hubspot.com/t5/APIs-Integrations/Not-possible-to-add-secondary-email-in-Contacts-API-Batch-Upsert/m-p/1068322)”.  
I have asked the Team to update the documentation accordingly, sorry about this.  
Hi [@sylvain\_tirreau](https://community.hubspot.com/t5/user/viewprofilepage/user-id/601366), [@zach\_threadint](https://community.hubspot.com/t5/user/viewprofilepage/user-id/324811) and @Anton do you know of other ways to add secondary emails via API to help @PabloOsorio, please?  
Have a beautiful day and thanks so much for your help! ⭐  
Bérangère

---

<div class="post-metadata">

**Author:** ![zach\_threadint](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/zach_threadint/32/46318_2.png) [@zach\_threadint](https://community.hubspot.com/u/zach_threadint)\
**Post date:** [April 10, 2025, 1:14am UTC](https://community.hubspot.com/t/add-additional-email-via-api-v3-hs-additional-emails/129538/3 "2025-04-10T01:14:42Z")

</div>

Hi @PabloOsorio 👋

You’ve rightly pointed out [the documentation](https://developers.hubspot.com/docs/guides/api/crm/objects/contacts#secondary-emails) needs to be updated. It currently states:

_To add secondary emails to a contact, when creating or editing the contact, in your request body, include emails in the hs\_additional\_emails field. Multiple emails can be separated by a semi-colon._

Given this property is “read only” (i.e. modificationMetadata.readOnlyValue = true), updating it via the relevant API V3 endpoints is not possible. As far as I know, [the V1 endpoints](https://developers.hubspot.com/docs/reference/api/crm/objects/contacts/v1#add-a-secondary-email-address) are still operational, so I think you’ll have to use them for now.

I hope this proves helpful. Please let me know if you have any follow-up questions.

---

<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:** [April 11, 2025, 10:00am UTC](https://community.hubspot.com/t/add-additional-email-via-api-v3-hs-additional-emails/129538/4 "2025-04-11T10:00:40Z")

</div>

Hi [@zach\_threadint](https://community.hubspot.com/t5/user/viewprofilepage/user-id/324811) and @PabloOsorio, I hope that you are well!  
I am glad to let you know that, thanks to your feedback, the Team has updated the documentation “[Additional emails](https://developers.hubspot.com/docs/guides/api/crm/objects/contacts#additional-emails)” 🙌  
I hope this will help future Community Members!  
And thanks so much [@zach\_threadint](https://community.hubspot.com/t5/user/viewprofilepage/user-id/324811) for pointing @PabloOsorio to another documentation, really appreciate your help! ❤  
Have a fantastic weekend! 🌞  
Bérangère