There's a new version of the HubSpot API

Check out the new API
View Beta Docs

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

Add a secondary email address

Last updated May 15, 2023

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

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:

PUT

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

CRM

Required Scope:

content

Add a secondary email address to a contact.
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"
Email Address :email
Used in the Request URL		 The email address you wish to add as a secondary email address

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example PUT URL: https://api.hubapi.com/contacts/v1/secondary-email/21316/email/newlyDiscoveredAddrress@hubspot.com Example response: { "portalId": 589323, "vid": 21316, "secondaryEmails": [ "updatedAddress@hubspot.com", "newlyDiscoveredAddress@hubspot.com" ] }