There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

SMTP API Tokens - Password Reset

Last updated June 17, 2020

POST /email/public/v1/smtpapi/tokens/:userName/password-reset

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?


Required Scope


Once you have an SMTP API, the List SMTP API Tokens endpoint can be used to list all SMTP API Tokens in the portal. However, for security reasons the password is only provided during the time of the token creation. This endpoint allows for the creation of a replacement password for a given Token, keyed by the userName field. Once the password is successfully reset, the old password for the token will be invalid.

Note that use of API requires the Transactional Email add-on.

Required Parameters How to use Description
OAuth Access Token Authorization: Bearer {token}
Used in the request headers

Used to authenticate the request. Please see this page for more details about authentication.
NOTE: You must use an OAuth access token to create an event. API keys are not supported.

userName Used in the request URL The userName field of the SMTP API Token needing a password reset.


Example URL: POST

Example JSON Response

  "portalId": 62515,
  "userName": "",
  "password": "ItUuCc8h4I5MihiysY8HB6XSbWZmVZ",
  "passwordHash": null,
  "emailCampaignId": 14860979,
  "createdAt": 1415740569008,
  "deleted": false,
  "createdBy": "",
  "appId": 22709,
  "campaignName": "test transactional email"


After resetting the password for the token above, you can use SMTP to send an email:
  • SMTP Hostname:
  • SMTP Port: 587 (for STARTTLS) or 465 for TLS
  • SMTP User Name:
  • SMTP Password: 3432fff8eljl1249fjjasdfnv3