Update Secondary Email v3 API

Develop, Build & Integrate APIs & Integrations
, ,
2

Hey, @ArminK :waving_hand: Quick questions to help the community better understand what you’ve already tried.

  • Specifically, which endpoints are you currently using?

  • Is it one of the Secondary Endpoints listed here? Developer Preview — Secondary Email Addresses

  • For adding, updating, and deleting a secondary email address, the above endpoints are the current option

  • If you only need to get the secondary email addresses, you can use the hs_additional_emails property ​to list the primary and secondary addresses in other calls to the Contact endpoints
    Quick example (I used cURL, but the NodeJS example works as well)
    EndpointGET/crm/v3/objects/contacts/{contactId}​Request

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

    Response

    HTTP 200

{
 "id": "551",
 "properties": {
 "createdate": "2022-08-11T23:27:36.511Z",
 "hs_additional_emails": "ihatethefood@cat.com;younewcatboss@cat.com",
 "hs_object_id": "551",
 "lastmodifieddate": "2022-08-15T20:37:13.785Z"
 },
 "createdAt": "2022-08-11T23:27:36.511Z",
 "updatedAt": "2022-08-15T20:37:13.785Z",
 "archived": false
}

The Developer Preview — Secondary Email Addresses endpoints already work with OAuth and Private Apps. Please be aware these endpoints are all part of the developer preview program and are subject to the following:

“This endpoint is part of our developer preview program, and should be considered as a non-stable release that will be subject to bugs and breaking changes while under development. Please take this into account as you build against a release. Please subscribe to our changelog for updates.”

Best,

Jaycee