Docs / HubSpot / Connecting HubSpot

Connecting HubSpot

Connect your HubSpot account so transjt can deploy your theme straight into it.

Before you start

  • A HubSpot account. Any plan works, including the free one.
  • Super Admin rights in that HubSpot account. Without them, HubSpot does not let transjt install the theme.

Connect HubSpot

You can connect HubSpot in two places: under Settings > Integrations, or later in the Deploy step of your project.

Option 1: in Settings

  1. In transjt, open Settings > Integrations.
  2. Click + next to Add CMS.
  3. In the Select CMS dialog, choose HubSpot and click Proceed.
  4. A HubSpot window opens (OAuth). Log in to HubSpot, choose the account you want to connect under Select an account, and click Select account.
  5. Back in transjt, the account appears in the list with the connection status O.K.

Option 2: in the Deploy step

  1. Open your project and go to the Deploy step.
  2. Click Add HubSpot.
  3. A HubSpot window opens (OAuth). Log in to HubSpot, choose the account under Select an account, and click Select account.
Allow the popup. HubSpot's login opens in a separate window (OAuth). Browsers often block it. If nothing happens after you click, allow popups for app.transjt.ai in your browser and try again.

You can also start from HubSpot: the transjt app is listed in the HubSpot Marketplace. In transjt, Plugins links to it as well.

Settings > Integrations > Add CMS > HubSpot
HubSpot window app.hubspot.com: transjt.ai is being connected to HubSpot, with Select an account, a list of HubSpot accounts and the Select account button
The HubSpot window: choose your HubSpot account and click Select account.

Link the account to a project

A project deploys to one HubSpot account. You link it in the Deploy step:

  1. Open your project and go to the Deploy step. You see Ready to deploy with your current package.
  2. Click Deploy Theme to HubSpot.
  3. If the project is not linked yet, Select Account or Add new opens: pick an account under Select Existing Account, or click Add HubSpot to connect a new one. Log in to HubSpot in the window that opens and authorize transjt.
  4. Click Deploy.

Once the project is linked, the account step is skipped and the theme is deployed directly.

Previous packages. Every export is kept as a package in the Deploy step. You can download an older package or deploy it to HubSpot again, for example to go back to an earlier version. See Previous packages.
Ready to deploy for a HubSpot project: the current package with its components, Download Theme and Deploy Theme to HubSpot, and a list of previous packages
Ready to deploy: click Deploy Theme to HubSpot.
The Deploy step in transjt for a HubSpot project: Select Account or Add new, with the Add HubSpot button, the Select Existing Account dropdown and the Deploy button
Deploy step: add a new HubSpot account or select an existing one, then click Deploy.

Several HubSpot accounts

Agencies often connect one HubSpot account per client. Every connected account appears as its own line under Settings > Integrations. Before you deploy, check in the Deploy step that the right account is selected.

Settings, Integrations in transjt: Add CMS and Add Repository, and a list of connected HubSpot, WordPress and GitHub accounts, each with the connection status O.K., the creation date and a bin icon
Settings > Integrations: all connected accounts with their status. The bin icon removes a connection.

Remove a connection

In Settings > Integrations, click the bin icon next to the HubSpot account. You can also uninstall the transjt app on the HubSpot side, under Settings > Integrations > Connected Apps.

Your projects stay as they are, and so does everything already exported to HubSpot. A project that used this connection is no longer linked; select an account again in the Deploy step.

Troubleshooting

  • The theme does not show up in HubSpot. It appears only after your first export. Check that the export finished in Tasks, and that the account selected in the Deploy step is the one you are looking at.
  • HubSpot refuses access. Log in with a user who has Super Admin rights in that account.
Previous← HubSpot Marketplace