There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

How do I create a test account?

You can use test accounts to test an integration without affecting any real HubSpot data. Test accounts have access to Enterprise versions of the HubSpot Marketing, Sales, and Service Hubs, allowing you to test most HubSpot tools and APIs.

Test accounts are created and managed within developer accounts. If you don’t already have a developer account, you can sign up for one here.

Once you sign in to your developer account, you'll have the option of creating an app or creating a test account.

dev_landing_dash

You can also get to the Testing dashboard using the Testing link in the top navigation menu.

On the Testing dashboard, click the orange button that says “Create test account.” This page will also show any existing test accounts, their expiration date, and connected apps. Once your test account is created, you can install your integration.

test_account_list

Expiration and renewal

Test accounts expire after 90 days. They can be renewed in two ways:

  • Manually: Go to your developer account’s Testing dashboard and hover over the row for the test account you want to renew. Click the “Renew” button. (See above.) This resets the 90-day clock for your account. Accounts can be manually renewed up to 90 days after their original expiration date.
  • Using an API call: If your test account was authenticated using an OAuth access token, any API calls made to that account will automatically renew it.
    • This only applies to API requests made using OAuth tokens generated from an application in the same developer account as the test account you want to renew.
    • Renewals must be made no more than 30 days before the test account’s expiration date
    • API requests made using OAuth outside the 30-day window will not automatically renew the test account.