Skip to content

HubSpot requirements and permissions

What your HubSpot account needs, what the app can access, and who can change Transactional Email settings.

Transactional Email runs entirely inside HubSpot. This article covers what your HubSpot account needs, what the app asks HubSpot for when you install it, and who on your team can do what.

Requirement Why
At least one Professional or Enterprise hub that includes workflows The app sends from a workflow action, and workflows need a Professional or Enterprise hub.
Access to HubSpot’s marketing email editor Templates are HubSpot marketing emails. You don’t need Marketing Hub Professional or HubSpot’s own transactional email add-on.
App Marketplace Access for the person installing HubSpot only lets users with this permission install apps. Super Admins have it.

Recipients don’t need to be marketing contacts, and Transactional Email sends don’t count toward HubSpot’s marketing email send limits.

When you install, HubSpot asks you to approve these permissions:

  • Contacts — read contacts to look up the recipient and fill in tokens, and write the three Transactional Email contact properties.
  • Contact properties — create the Transactional Email property group and its properties.
  • Companies — read the recipient’s primary company for {{ company.* }} tokens.
  • Marketing emails — list your emails when you add a template, and read the emails you add.
  • Workflows — provide the Send transactional email action.
  • Timeline — add Sent, Bounced, and Complaint events to the contact timeline.
  • Users — check whether you’re a Super Admin, so only Super Admins can change settings.

HubSpot also asks for these optional permissions. The app installs and sends without them; they’re only used for tokens from the record a workflow is enrolled on:

  • Deals, tickets, quotes, invoices, orders, and subscriptions — read the enrolled record and its property settings, to fill in tokens such as {{ deal.* }} or {{ order.* }}.
  • Custom objects — read the enrolled custom object record, its property settings, and your account’s custom object definitions. Custom objects need HubSpot Enterprise.

See Personalizing emails with tokens.

If your account installed Transactional Email before these permissions existed, or someone left them unchecked, a Super Admin can grant them. Your settings and templates are kept.

  1. If the permissions show a lock on HubSpot’s connect screen, they’re turned off for this app in your account. Hover over the lock and click Go to admin settings. On the Data Permissions tab, turn on the optional permissions (or click Enable All), then click Save changes.
  2. Install the app again from its Marketplace listing. On the connect screen, check the optional permissions (or click Select All), then click Connect app.

The tokens start filling in within an hour.

To see which permissions the app can use in your account, a Super Admin can run a check:

  1. In Settings, open the Usage and Statistics tab.
  2. Under HubSpot access, click Check HubSpot access.

The app asks HubSpot which permissions your install granted, makes one read for each granted permission it can test, and lists every permission it asks for, with what it’s used for and a status:

Status Meaning
Working The app just read from HubSpot with this permission.
Granted Your install granted the permission. The app only uses it to write, such as timeline events, so the check doesn’t test it.
Not granted Your install didn’t grant the permission, or HubSpot refused the read for lack of it. For an optional permission, see Granting the optional permissions.
Not checked There was nothing to read, such as custom object records in an account that has none, or the app couldn’t get your install’s permissions from HubSpot.
Check failed The read failed for another reason, such as HubSpot’s rate limit or a feature your HubSpot subscription doesn’t include. Try again in a minute.

The check doesn’t change anything in your account.

Task Who
Install or uninstall the app Users with App Marketplace Access
Add the Send transactional email action to a workflow Anyone who can edit workflows
View App Home and every Settings tab — including Sending Setup, Billing, and Alerts — and search the send log Every user in the HubSpot account
Change Settings: sender profiles, sending domain, templates, billing, alert recipients Super Admins only
Accept the Acceptable Use Policy, subscribe, open Manage billing Super Admins only
Add, remove, or refresh a template; resume paused sending; clear a suppressed address; check HubSpot access Super Admins only

Users who aren’t Super Admins see Settings with a View only notice: they can read every tab — sender profiles, the sending domain and its DNS records, templates, billing, and alert recipients — but get no buttons to change anything. If you need a change, ask a Super Admin in your HubSpot account.

Can I give a non-admin access to Settings? Not separately. Transactional Email follows the HubSpot Super Admin role. Make the person a Super Admin in HubSpot, or ask an existing Super Admin to make the change.

Does the app change my existing contacts? Only the three Transactional Email properties — after a send, a bounce or complaint, or when a Super Admin clears a suppressed address. It never edits other properties.