Skip to content

HubSpot developer permissions guide (BETA)

Last updated: September 30, 2024

Available with any of the following subscriptions, except where noted:

All products and plans

In addition to HubSpot's other user permissions, HubSpot provides a Developer tools access permission for accessing developer-specific tools in HubSpot. This includes access to the CRM development home space and developer tools such as projects, apps, and more.

developer-tools-access-permission-off

Along with the Developer tools access permission, HubSpot also provides a Developer permission template, which includes the developer tool access plus a set of permissions that are commonly needed when developing on HubSpot.

developer-permission-template

If you're a Super Admin or have permission to add & edit users, you can assign these permissions to your account's users. Below, learn more about the Developer tools access permission, the Developer permission template, and how to assign them.

What's included

Learn more about what permissions are included in the Developer tools access permission and Developer permission template.

Please note: many of the features made accessible by the Developer tools access permission are part of the CRM development tools to build UI extensions with React as frontend beta (Sales Hub and Service Hub Enterprise only). Learn how to opt your account into the public beta.

Developer tools access permission

The Developer tools access permission provides access to the following:

  • The account's developer home space, which you can find under CRM Development of the account's main navigation menu. In this space, they'll also have access to developer onboarding tasks to get them started. Only available for the CRM development tools beta.

    crm-development-home-page
  • Developer projects which are used to build and deploy apps to the account from their local environment.
  • App management, which includes creating and managing private apps, as well as accessing settings for installed public apps.
  • Their personal access key, which is used for authenticating the account in the HubSpot CLI for local development.
  • Development sandboxes (Sales Hub and Service Hub Enterprise only), which can be used for testing during private app development. Only available for the CRM development tools beta.

Please note: while the Developer tools access permission enables access to these tools, a developer will still require additional permissions depending on what they're building. This is because their user permissions determine the types of data and assets that they and their integrations can access. For example, a developer would need Create custom line items permission if they're building a private app that will create line items for invoicing. Without that permission, they would be unable to configure their app to create custom line items.

Developers permission template

The Developers permission template includes access to all of the above, plus the following, depending on your HubSpot subscription:

  • CRM objects: view/edit/delete access for contacts, companies, deals, tickets, tasks, notes, and invoices. Does not include permission to approve deals.
  • CRM tools: access to CRM emails, meetings, and calls that they own, along with the ability to:
  • Marketing:
    • View/edit access to lists and forms. Does not include permission to delete form submissions. 
    • Marketing Access, which enables access to the Marketing main navigation menu item.
    • View/publish access to ads and campaigns.
    • View/edit access to marketing emails.
    • View/edit/publish access to blogs, landing pages, and website pages.
    • View/edit/publish access to HubDB (Content Hub Professional and Enterprise, and Marketing Hub Enterprise).
    • View/publish access to URL redirects (Content Hub Starter, Professional, and Enterprise, and Service Hub or Marketing Hub Professional and Enterprise).
    • Design tools access.
    • Content staging access (Content Hub Professional and Enterprise). 

Please note: if you had previously set a developer as a Super Admin and want to migrate them to the new developer permissions, it's recommended to start with the Developer permission template. The template will include a set of permissions that are commonly needed when developing on HubSpot beyond access to the developer tools. 

Assign developer permissions

To assign the Developer tools access permission or Developer permission template to a user:

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Users & Teams.
  • Edit an existing user's permissions by hovering over the user, then clicking Edit permissions. Or, create a new user.

    user-edit-permissions
  • To assign the user the Developer permission template:
    • Click to expand Choose how to set access, then select Start with a template.

      choose-permission-template
    • Click to expand Choose permissions, then click the Choose a role or user-based template dropdown menu and select Developer.

      developer-permission-template
  • To assign users the Developer tools access permission:
    • Under Choose permissions, navigate to AccountSettings access.

      choose-permissions-settings-access
    • Scroll down and click to toggle the Developer tools access switch on.

      developer-tools-access-permission-toggle
  • Continue customizing their permissions if needed by toggling other permission switches on/off.
  • When you're done making changes, click Save in the top right. The user will need to log out then log back in before updates to their permissions take effect.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.