Developing apps overview
Apps are a package for any functionality you want to share with HubSpot users or another HubSpot account. Apps also enable you to develop using features like custom CRM cards, timeline events, and webhooks. When developing an app, HubSpot has a number of tools to get your app or integration up and running. Below, learn more about the components of app development.
While app developer and test accounts work together, they each serve a distinct purpose.
- Developer accounts are where you can build and list apps.
- Test accounts allow you to try our APIs and test the apps you’re building without impacting data from a real HubSpot account. This is separate from a sandbox account that you can create within standard HubSpot accounts.
Learn more about HubSpot's account types.
Please note: starting November 30, 2022, HubSpot API keys will no longer be able to be used as an authentication method to access HubSpot APIs. In addition, starting July 15, 2022, accounts without a HubSpot API key already generated will no longer be able to create one.
If you want to subscribe to webhooks or set up OAuth for your app, you should create a developer account. With developer accounts, you can also list your apps on the App Marketplace or create a test account.
Developer account API keys
To manage your app settings through the API, you can use a developer API key. This includes managing subscriptions for the Webhooks API and creating or updating event types for the timeline events feature.
Developer API keys can only be used for making API calls to update an app's settings. All other API calls need to be made using a private app access token or OAuth.
To access your app developer account API key:
- In your app developer account, navigate to Apps in the top navigation bar.
- In the upper right, click Get HubSpot API key.
- In the dialog box, click Show key. The key will be revealed, and you can then click Copy next tot he key.
- You can also deactivate the previous API key and generate a new one by clicking Regenerate key.
HubSpot logs all requests made to or from a connected app, including incoming requests using an OAuth access token or outgoing requests for webhooks or CRM cards.
To view this request log:
- In your app developer account, navigate to Apps in the main navigation bar.
- Click the name of the app.
- In the left sidebar menu, navigate to Monitoring.
- Use the tabs to view different types of requests being made to or from the app. While viewing these logs, you can click an individual request to view more information about it, including:
- for successful requests, the request method, path, and time of request.
- for unsuccessful requests, additional error information such as response headers and body.
Below, learn more about each tab of the Monitoring page.
The API call log will list all requests made to your app using an OAuth access token. It can be filtered by HTTP method, response code, timeframe, or request URL.
The Webhooks tab shows HubSpot requests for any of your app’s webhook subscriptions. Filter by response (including timeouts and connection failures), status (success, will retry, or failure), subscription type, time frame, attempt, batch, event, or account ID.
Please note: the attempt ID is a combination of the
attemptNumber from a specific request.
You’ll find HubSpot requests for your app’s CRM cards in the CRM extensions tab. Filter by extension object type, CRM object type (contact, company, ticket, or deal), error or warning type, time frame, request ID, or CRM record ID (i.e. a specific contact ID).
You can delete app developer accounts if they don’t contain apps with installations or active marketplace listings. If your account has apps with installations or active marketplace listings and you’d like to delete your account, please reach out to support for assistance.
Once you delete your account, you will no longer be able to access that account. If you can switch between multiple HubSpot accounts, the deleted account will no longer appear.
In your HubSpot API developer account, click your account name in the top right corner, then click on Account.
Click on Delete account. If your account has any apps with installations or active marketplace listings this button will be disabled.
In the dialog box, enter your account ID then click Delete developer account