List SMTP API Tokens

Last updated February 21, 2019

GET /email/public/v1/smtpapi/tokens

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?


Required Scope


List SMTP API tokens which can then be used to send email through HubSpot's SMTP API. Tokens listed here were created using the Create SMTP API Tokens endpoint.
Note that this API will not return passwords. Passwords are only returned during token creation, and during password reset (at which point a new password is generated).

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

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.


Example URL:

Example JSON Response

      "portalId": 62515,
      "userName": "",
      "emailCampaignId": 14845842,
      "createdAt": 1415660606232,
      "deleted": false,
      "createdBy": "",
      "appId": 22709,
      "campaignName": "TransactionalTest"
      "portalId": 62515,
      "userName": "",
      "emailCampaignId": 14845848,
      "createdAt": 1415660619230,
      "deleted": false,
      "createdBy": "",
      "appId": 22709,
      "campaignName": "TransactionalTest12"
The emailCampaignId and appId fields above can be used in the Email Events API.