*This document and video were produced by walkthrough.ai. If you're interested in producing similar educational content and documentation for your digital products and services, contact us today!
This document is a step-by-step guide explaining the steps required to create a Private App in Hubspot, which is required to integrate and authenticate 3rd party applications using the Hubspot API.
Learning how to create a Private App in Hubspot is helpful and important because it allows you to integrate and authenticate 3rd party applications using the Hubspot API. This is a necessary step for businesses that want to take advantage of all Hubspot offers, including its ability to build custom applications on top of Hubspot.
1. Open your Hubspot Account
Open your Hubspot account by going to the Hubspot website and logging into your account. If you do not already have an account, you can create one for free at HubSpot signup.
2. Click on the gear icon ("Settings")
In the top nav, click on the gear icon to navigate to your account's settings page.
3. Click on Private Apps
In the left menu, find the "Private Apps" section under the "Account Setup" section.
4. Click the "Create a private app" button
Once in the Private Apps area, go ahead and click on the "Create a private app button".
5. Fill out the Private App
A name for your Private App is required, and a logo a description are optional. Go ahead a fill out the form with relevant information.
6. Click on Scopes
After filling out the Private App form, you'll want to click the "Scopes" tab above the form.
7. Select all Required Scopes
Scopes are a way of granting third-party applications or services permission to access certain data on behalf of a user. When creating a private app in Hubspot, users can select specific Scopes to which the app will have access.
In this guide, we select the `crm.objects.contacts.read` and `crm.objects.contacts.write` Scopes. This will ensure that the API Token created for the Private App can create, read, update, and delete contact records via the API.
8. Create the Private App
Click the "Create app" button to create the Private App.
9. Read the warning and click on "Continue creating"
Tokens generated for a private app in Hubspot are especially sensitive and should never be shared. These tokens provide access to the data associated with your Hubspot account, so if someone were to obtain it, they could have control over this data. To ensure the security of your data, it is important to store API tokens securely and protect them.
10. Click on "Show token" and "Copy"
After the Private App is created, you can reveal the API token to use it. To do this, click the "Show token" button and copy it.
A token generated from a Hubspot Private App can be used as a bearer token when making API calls. In this case, the token allows access to data associated with the Hubspot account, such as contacts and other CRM data. The token essentially works like an authentication key which is sent along with every request made to the API.
In this step-by-step guide, you learned how to create a Private App in Hubspot, which is required to integrate and authenticate 3rd party applications using the Hubspot API. To dive deeper into other topics, please review our other guides and tutorials!