Skip to content
Email

Send transactional emails

Last updated: December 3, 2021

Applies to:

Marketing Hub Professional, Enterprise
CMS Hub Professional, Enterprise
Legacy Marketing Hub Basic

The transactional email add-on gives Marketing Hub customers a dedicated IP address to send emails for commerce receipts, account updates, terms of service changes, and other essential business transactions.

Transactional emails are for relationship-based interactions, unlike marketing email, which is typically used to promote your content.

You can create and send a transactional email directly in your HubSpot account, or you can use the transactional email API to send emails using an SMTP API or single-send API token.

Please note: transactional email is an optional product add-on. Contact your HubSpot customer success manager or sales representative for further details.

Create a transactional email in HubSpot

To send a transactional email through HubSpot or via the single-send API:

  • In your HubSpot account, navigate to Marketing > Email.
  • Click Create email.
  • In the dialog box, select Regular for the email type.
  • Select a template.
  • Edit your email. You can use personalization tokens in transactional emails, just as you would with your marketing emails.
  • Click the Settings tab.
  • Click the Subscription type dropdown menu and select Transactional. Because transactional emails bypass subscription preferences, your email will not include a subscription link.

select-transactional-email-in-email-settings-1

  • Send or save your email:
    • To send a one-off transactional email, such as a terms of service change, you can send or schedule your email on the Send or Schedule tab.
    • To use your transactional email in a workflow, click the Actions dropdown menu in the upper right, then select Save for automation. Learn more about using emails in workflows.
    • If you plan to send the transactional email using the single-send API:
      • Click the Actions dropdown menu in the upper right and select Convert to single send API.
      • After you finish creating your email, you can copy the email ID when using the single send API. Learn more about sending a transactional email using the single send API in HubSpot's developer documentation.

email-details-page-single-send-api

Please note: HubSpot will deliver a transactional email to a contact regardless of their quarantine status, subscription status, or double opt-in status. If a contact marks a transactional email as spam and a spam report is generated, it may appear as an unsubscribe event in HubSpot.

Send a transactional email using the SMTP API

If you want to integrate with a third party or internal system to trigger your transactional email and incorporate data stored outside of HubSpot, you can generate a token to send transactional emails via the SMTP API. These emails will include the HubSpot tracking code that allows full engagement tracking and measurement.

You can generate and manage your tokens directly in HubSpot, or you can use the transactional email API. Learn more in HubSpot's developer documentation.  

Generate an SMTP API token in HubSpot

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to Marketing Email.
  • Click the SMTP tab.
  • In the top right, click Generate token.
  • In the dialog box, enter a name for your token. If you want to create contacts for each new recipient of your emails, you can optionally select the Automatically create contacts for recipients of email checkbox.
  • Click Generate token.
  • HubSpot will generate a username and password associated with your token, which you can use to make SMTP API calls. Learn more about how to send a transactional email with your token in HubSpot's developer documentation.

smtp-token-generated-modal

Please note: make sure you copy the password and store it in a secure place, as you cannot retrieve it later for security reasons. If you lose your password, you can always reset it by following the instructions below.

Manage your SMTP API tokens in HubSpot

You can use the username and password associated with an SMTP API token to send transactional emails from your own internal system or a third party integration.

After you start sending emails using the token, you can analyze certain metrics like open rate and click-through rate in your HubSpot account. If you misplaced the token's password, you can also reset or delete it.

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to MarketingEmail.
  • Click the SMTP tab.
  • Hover over the token and click the Actions dropdown menu:
    • To view the performance of all emails sent using the token, select View details.
    • To reset the password associated with the token, select Reset password. In the dialog box, confirm that you'll no longer be sending transactional emails using the current password, then click Reset password.
    • If you no longer want to send emails using the token, you can delete the token's password by selecting Delete. In the dialog box, click Delete.
manage-smtp-api-tokens-in-hubspot-1