Creating a Custom OAuth Application

CData embeds OAuth Application Credentials with CData branding that can be used when connecting via a desktop application or headless application. If you would rather use your own OAuth credentials, you can create a custom application with HubSpot.

Legacy Application Creation Deprecated

HubSpot has permanently disabled the creation of new legacy public applications via the Developer Platform UI.

• New accounts (created on or after May 26, 2026): Legacy public application creation is disabled as of May 26, 2026.
• Existing accounts (created before May 26, 2026): Legacy public application creation is disabled as of June 23, 2026.

Existing legacy applications are not affected and will continue to function as-is. New public applications must be created using the HubSpot Projects-based application platform. Follow the updated procedure below.

Procedure

To use your own OAuth credentials, configure redirect URIs and permissions, or control which scopes are requested, follow the steps below to create an application and obtain the OAuthClientId and OAuthClientSecret using the HubSpot CLI.

Prerequisite

To create an application, install the HubSpot CLI (v7.6.0 or later) and authenticate it with your account using the following command:

hs account auth

If you have already installed the CLI, you can update to the latest version by running:

npm install -g @hubspot/cli@latest

Create a new boilerplate project

1. Run the following command:
   

   hs project create

   1. [--name]: Enter your project name.
   2. [--dest]: Choose where to create the project.
   3. When prompted to select the base contents of your project, select App.
   4. [--distribution]: Select whether you plan to distribute your application on the HubSpot Marketplace or want to restrict installation to specific HubSpot accounts.
   5. [--auth]: Select whether you want to use OAuth for the ability to authenticate multiple accounts, or opt for a static token to limit installation to a specific account.
   6. [--features]: Select which application features to include.
   The HubSpot CLI will create a top-level project directory, as well as subdirectories for the application features you chose.
2. Set up OAuth (and other configurations as per your needs) in the app-hsmeta.json file by configuring redirectUrls, requiredScopes, and optionalScopes (see the OAuthRequiredScopes and OAuthOptionalScopes properties for the default scopes requested by the provider).
3. Upload your project with the following command:
   

   hs project upload

4. In the terminal, run the following command from within your local project directory to open the project details page in HubSpot:
   

   hs project open

5. Under Project Components, click the name of your application. Under the Auth tab you can find the client Id and client secret.

For further details, see: Create a new app using the CLI: HubSpot Docs.