--- title: "Connect Clarity Security to Hubspot" slug: "hubspot" description: "Learn how to connect Clarity Security to Hubspot to automate your identity life cycle management and user access reviews." tags: ["How-To", "marketplace", "application", "Integrations"] updated: 2023-05-03T16:50:34Z published: 2023-05-03T16:50:34Z canonical: "help.claritysecurity.com/hubspot" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Hubspot This guide will teach you how to set up the connector between [HubSpot](https://www.hubspot.com) and [Clarity Security](https://claritysecurity.io). **Estimated time to complete:** 10 minutes If you encounter any problems, please contact your support team or [support@claritysecurity.io](mailto:support@claritysecurity.io). ## Supported Connector Capabilities ## Below are capabilities supported by the connector at this time. | **Method** | **Supported** | | --- | --- | | Provision User | Yes | | List Groups, Policies, and Roles | Yes | | Add User to Groups, Policies, and Roles | Secondary Teams Only | | Remove User from Groups, Policies, and Roles | No | | Deactivate User | No | | Delete User | Yes | ## ## How to Setup the Connector ### Step 1: Navigate to HubSpot and get signed in > [https://hubspot.com](https://hubspot.com) ![Hubspot Logged In](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679515609315.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=s%2Bk3laPOkYaQJZbobjz8CDX6NAbcxI6nN461kUDcnPI%3D) ### Step 2: Click Settings Click the settings icon in the upper right (this looks like a gear). ![HubSpot Settings button](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/hubspot%20login.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=8nUuGhpSq9k4dXY9C8ehAQGvGhT5m7VSJo5gJI55YZU%3D) ### Step 3: Navigate to Integrations > Private Apps In the left sidebar menu, locate the Integrations section, and select Private Apps from that list. ![Settings > Integrations > Private Apps](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/hubspot%20integration%20private%20apps.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=PivQpvg9yDjzN19NflKEBa%2Fi%2BY1Acf9lKQ3C4qqnj8c%3D) ### Step 4: Click Create a private app Click the Create a private app button to start creating an app. ![Create private app button](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679516091667.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=M7JE7XlvYevh73s6PCGSsu%2FmAwvp2DCiaKl2dvxABZ4%3D) ### Step 5: Fill out Basic Info Fill out the Basic Info tab using the following information. - **Name**: Provide an App Name Ex: Clarity Connector - **Logo**: Use the placeholder logo or upload one. - **Description**: Enter a description for your App, Ex: Connector application for Clarity Security ![HubSpot App Config - Basic Info](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679517007349.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=riW5l6VLGwMOVV24KG1ZuPXzm1BVuRi3ArI%2F%2BlWgOtM%3D) ### Step 6: Add the Scopes Navigate to the **Scopes** tab (near the top of the App configuration page), and add the scopes listed below. Once you have configured the required scopes, click **Create app** in the top right. - **settings.users.read** - **settings.users.write** - **settings.users.teams.read** - **settings.users.teams.write** - **settings.billing.write** ![Hubspot App Config - Scopes](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679517294394.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=sikwBS2dIpjzsV%2FD3kgitwfWkbjKgueJNEknpFDm%2BEk%3D) ### Step 7: Create a new private app pop-up Once you hit **Create app** on the previous screen, you will get a pop-up like the one below; hit **Continue creating** to continue to the API credentials. ![Create new private app pop-up warning](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679517711745.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=0Ydw2rVsJtZXrE4c56G7J4gYnYGQapyn4Hqy%2FtJoCVc%3D) ### Step 8: Collect the private app credentials Collect the token from the "**Your private app was created"** screen; you will need this value later. ![Your private app was created - Token value](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679517833071.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=zIAbxo8jioTlF6ZUaWlUUPSm7QaCePCwB%2Fou2a6LQbY%3D) ### Step 9: Log in to Clarity Login to your Clarity Security tenant. > https://your_tenant.claritysecurity.io ### Step 10: Navigate to Applications, then Marketplace Click on the Applications side tab, then click on the Marketplace to list all the available connectors. ![Applications > Marketplace](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679518028210.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=M%2FJc9M86VGfwc8xZtQu6sLSpyhCfzRhJ%2B9re7Y5X85Q%3D) ### Step 11: Find HubSpot Scroll to or search for **HubSpot** in the list of applications from the marketplace, then click **Connect**. ![Marketplace > HubSpot](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679518088460.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=2pPJNhO9ITj%2B1z7YFmql8H3vaos2TMAhCsHnclJGJoY%3D) ### Step 12: Connect App Complete the App Settings form. Details for fields common to all applications can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-1-connect-app). - **api_key**: Paste the **token** value retrieved from **Step 8**. ![Configure App > Connect App - HubSpot](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679518209980.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=MBmX2Dit33NmiaC2WFYvv7coCQz9qke%2FLhnuTITf7FU%3D) ### Step 13: App Settings Complete the App Settings form. Details for each field can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-2-app-settings). ![Configure App Step 2 - App Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%202(3).png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=t6MCo3pKFY290DZaWC9yWFkbSlx7wQ6hojANu%2BBDRaY%3D) ### Step 14: User Settings Complete the User Settings form, check the table at the top to see if any features are unsupported. Details for each field can be found in the following article: [Common App Configuration Steps](/v1/docs/common-app-steps#step-3-user-settings). ![Configure App Step 3 - User Settings](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Configure%20App%203(2).png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A31%3A05Z&se=2026-11-22T18%3A31%3A05Z&sr=b&sp=r&sig=N5CkOhB9S%2FClILKM7uXfov48J%2FG5BbvbQxTQLAcXGBo%3D) ### Step 15: Validate Your Selections and Save SaveClicking the Save button will trigger the first full sync for your application (even if you selected Manual syncing).  This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes. ## Need Help? If you have any problems, contact your customer success team. You can also get in touch with our general support [via email](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST. A Service User is a user, or service account, discovered by Clarity in a downstream application. An Entitlement is an assignable permission found in a downstream application. Common examples include licenses, groups, and policies. Service User Entitlements are the pairings of users and active entitlement access in downstream applications. An attribute is a piece of information used to describe a service user, entitlement, or identity. Common examples include First Name, Last Name, Job Title, Department, etc.