Test accounts

What are test accounts used for?

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.

How do I create a test account?

Test accounts are created and managed within developer accounts. If you don’t already have a developer account, you can sign up here. You can create up to 10 test accounts per developer account.

dev_landing_dash

On the homepage of your developer account, click “Create a test account.” 

You can also do this using the “Testing” link in the top nav. Once you're 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:

  • 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 renewed up to 90 days after their original expiration date.
  • 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.
    • Requests must be made within 30 days of the test account’s expiration date.
    • API requests made using an API key or OAuth requests made outside the 30-day window will not automatically renew the test account.

Related docs

Working with OAuth

Developer tools and accounts

Creating and installing apps