There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Delete a secondary email address

Last updated May 31, 2023

DELETE /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:

DELETE

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

CRM

Required Scope:

content

Remove a secondary email address from 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 remove from the list of secondary email addresses