There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

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.


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.


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.