HUhubspot
SMTP Tokens

Create a SMTP API token.

Changed on

Create a SMTP API token.

post/marketing/transactional/2026-09/smtp-tokens

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/transactional/2026-09/smtp-tokens
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: transactional-email

Request body

campaignNamestring required

A name for the campaign tied to the SMTP API token.

createContactboolean required

Indicates whether a contact should be created for email recipients.

Response

successful operation

campaignNamestring required

A name for the campaign tied to the token.

createContactboolean required

Indicates whether a contact should be created for email recipients.

createdAtstring date-time required

Timestamp generated when a token is created.

createdBystring required

Email address of the user that sent the token creation request.

emailCampaignIdstring required

Identifier assigned to the campaign provided in the token creation request.

idstring required

User name to log into the HubSpot SMTP server.

passwordstring

Password used to log into the HubSpot SMTP server.

Changes