There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Get the secondary email addresses for a contact

Last updated May 15, 2023

GET /contacts/v1/secondary-email/:vid

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.

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


Returns an array of secondary email addresses associated with a contact.

Note: The secondary email addresses for a contact are included in the hs_additional_emails property for the contact. If you're already pulling other contact data, you can request the hs_additional_emails property in those requests to get the secondary email addresses without making a separate request to this endpoint.
Required Parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.
Contact ID :vid
Used in the request URL
Unique identifier for a particular contact. In HubSpot's contact system, contact ID's are called "vid"