How to add Secondary emails

Developer Support APIs & Integrations
1

Hi,

I’d like to know if there’s a way to add secondary emails, or additional emails, via the latest APIs.

This post suggested using a legacy endpoint, but this post dated a few months ago says that the hs_additional_emails property has been deprecated. Is there a replacement for this yet ? Or a plan to have one ?

Thank you !

2

Hey, @LeKevoid :waving_hand: Thanks for your question.

The fast answer is the v1 endpoints are stable and supported — “This is a stable API but uses an older format”. There was a time in the past when these endpoints were in a developer beta state. But as of the documentation in February 2025, these are the endpoints you need to set or update secondary email addresses:

Additionally, the property `hs_additional_emails`still works as a read-only property, it just cannot be updated via API. You need to use one of the above endpoints.

I helped someone else with the same endpoints recently, and I have a good example:

  • I made several requests to the Add and Update endpoints for my Contact Bob

  • I used the property `hs_additional_emails` in a request to the GET Contact by ID endpoint

    curl --request GET \
 --url 'https://api.hubapi.com/crm/v3/objects/contacts/901?properties=hs_additional_emails&archived=false' \
 --header 'authorization: Bearer NOPE'

    HTTP 200

{
 "id": "901",
 "properties": {
 "createdate": "2022-11-03T21:42:31.255Z",
 "hs_additional_emails": "bobbobbob3@bobsburgers.com;bobbobbob@bobsburgers.com;bobbobbob2@bobsburgers.com;bob2@bobsburgers.com",
 "hs_object_id": "901",
 "lastmodifieddate": "2025-02-07T16:58:38.463Z"
 },
 "createdAt": "2022-11-03T21:42:31.255Z",
 "updatedAt": "2025-02-07T16:58:38.463Z",
 "archived": false
}

I hope this helps! — Jaycee