Skip to content
HubSpot Developer Changelog

Changes to the public API demo account

Update: These changes are now live, and the demo API key will only be allowed to make GET requests.

When HubSpot launched our first public APIs in 2010, we created our public API demo account so that developers would have an account that could be used to test those new APIs. This was years before the launch of HubSpot's free CRM, so at the time the only alternative to the public demo account was to test against your paid HubSpot account that you were using for your actual business.

Since that initial launch, we've expanded the number of public APIs significantly, and we've released several new tools for developers, including things like our free test accounts, without any major updates to that original API demo account. With the overall growth of the HubSpot platform, as well as the support for our newer developer tools, that demo account is no longer the best way to test your integration.

We want to make sure that it's still easy to quickly see the data that is returned by HubSpot's APIs. However, once you're ready to start building your integration, you'll want to create a separate test account for any testing that you need to do.

What’s happening?

Beginning on Friday, August 9th, our public API demo account (accessed using the 'demo' API key) will only be allowed to make GET requests. Requests made using other methods (such as PUT, POST, or DELETE) will return an error.

Additionally, login will be disabled for the demo account, as the user for the demo account will be deactivated.

What’s changing?

As mentioned above, GET requests will continue to work as they do now, but any other request methods will return an error. If you have any tests running against the demo account using the 'demo' API key, tests that only make GET requests may continue to work, but any requests that manipulate data using other request methods will begin to fail.

The error response for non-GET requests will be a 403 error response code with the following format:

  "status": "error",
  "message": "Only GET requests can be made to HubSpot's demo account. You can create a test account to try other methods (",
  "correlationId": "f44e1352-e329-41e7-8efc-23ed7a83e5ef",
  "requestId": "eb89d11e86d87c6169b334eb318e143e"

Additionally, since the user will be deactivated, that user will no longer be able to log in to the account. This means that OAuth connections will no longer be allowed with the public demo account.

If you have any tests running against the public demo account, you will want to create a test account, and move any tests over to that new test account.

Test accounts have access to API keys, so you will be able to create a test account, generate a new API key for that account, and then swap that API key for the demo key. However, we do recommend that any testing be done using OAuth tokens. API requests made to a test account authenticated with an OAuth access token will automatically renew the test account.

When is this happening?

This change will happen on August 9th 2019.

If you have any questions please let us know by replying to this forum thread.