Home/HighLevel/Features/Developer Resources/HighLevel marketplace CLI: install, login, and workspace setup

Agency, Settings and Integrations

HighLevel marketplace CLI: install, login, and workspace setup

In short

The HighLevel Developer Marketplace CLI is a terminal tool that lets developers keep Marketplace app configuration in local JSON files, validate changes, compare versions, and publish apps, all without leaving their code editor or switching to the web UI.

AreaDeveloper Resources · Developer Resources
Used forSoftware startup, Consulting firm offering integration widgets, Agency managing multiple client apps
Setup steps9 steps in 4 tasks
Last updatedNovember 17, 2026

01Who this is for

  • Developers building custom Marketplace apps, they can keep configuration under source control and run validations locally.
  • Founders offering SaaS products through HighLevel, they can streamline publishing by using the CLI instead of the web UI.

02HighLevel Developer Marketplace CLI, explained

The CLI adds a single command called ghl that interacts with the Developer Marketplace. It can create a new app workspace, pull an existing app’s supported configuration into local JSON files, validate those files, compare differences, push updates, and finally publish or submit the app for review. All supported sections such as OAuth settings, webhooks, and billing plans are stored alongside your code.

The tool runs in your terminal after you install it globally via npm. After logging in and selecting the appropriate Developer Marketplace account, you work inside a local workspace that mirrors the app’s current Marketplace state. Commands like ghl app validate or ghl app diff provide safety checks before any data is sent to the platform, and flags enable non interactive use for CI pipelines or AI coding agents.

03How businesses use HighLevel Developer Marketplace CLI

  • Software startup. The team runs ghl app create to generate a new workspace, edits the JSON files for OAuth scopes, validates with ghl app validate, and then pushes the changes with ghl app push before publishing the private app directly.
  • Consulting firm offering integration widgets. Consultants pull an existing widget app using ghl app pull <appId>, update the webhook URLs in the local files, run ghl app diff to see modifications, and push the updates to keep the Marketplace version in sync.
  • Agency managing multiple client apps. The agency scripts ghl app pull and ghl app push in a CI pipeline, adding --json to read commands for structured output and --dry run to preview changes before automatically publishing eligible private apps.

04The numbers and rules that matter

  • Node.js 20.12 or later is required.

05Before you start

  • Node.js version 20.12 or later must be installed.
  • A HighLevel Developer Marketplace account is required.
  • The Marketplace CLI must be installed globally with npm.

06How to set up and use HighLevel Developer Marketplace CLI in HighLevel

Install the CLI

  1. Run npm install -g @gohighlevel/marketplace cli to install the package globally.
  2. Verify the installation with ghl --version.

Sign in

  1. Start authentication with ghl login.
  2. If you do not want the browser to open automatically, run ghl login --no browser and open the displayed approval URL manually.

Select a Developer Marketplace account

  1. List available accounts with ghl account.
  2. Switch to the desired account using ghl account switch.

Create or pull an app workspace

  1. Run ghl app create to start a new Marketplace app and generate a local workspace.
  2. Run ghl app pull <appId> to download the supported configuration of an existing app into a workspace.
  3. After the initial pull, execute ghl app pull again whenever you need to refresh the local files with the latest Marketplace state.

07What it looks like in HighLevel

08Settings that matter

  • --json. When added to supported read commands, this flag returns structured JSON output instead of human readable text.
  • --force. Allows destructive commands to run without interactive confirmation, useful for scripted or CI environments.
  • --dry run. Shows the planned changes for a command without applying them, helping to review actions before execution.
  • --no browser. Prevents the CLI from opening a browser automatically during login, requiring you to manually visit the displayed approval URL.

09Things to know before you rely on it

  • Public and private apps follow different publishing behavior; only eligible private apps can be published directly.
  • Marketplace validation and publishing requirements still apply when using the CLI.
  • Destructive commands require confirmation and can require --force in non interactive workflows.
  • Availability of the --json flag depends on the specific command being used.

10How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

The CLI is a handy way to keep Marketplace app work inside your code base.

If you never touch the Marketplace UI or don’t need scriptable automation, you can safely skip it.

Get More InformationOpens on HighLevelPublished November 3, 2026 · Updated November 17, 2026

Common questions

Common questions about HighLevel Developer Marketplace CLI.

What command does the Marketplace CLI use?

The CLI operates through the ghl command, which provides sub commands for app creation, validation, diffing, pushing, and publishing.

What version of Node.js is required?

Node.js version 20.12 or later is required to install and run the HighLevel Marketplace CLI.

Can I use the CLI with an existing Marketplace app?

Yes. Use ghl app pull <appId> to create a local workspace that mirrors the current configuration of an existing app.

What does ghl app diff do?

It compares your local changes with the last synchronized state and the current Marketplace state, helping you see what will be updated before pushing.

Does ghl app push replace the entire app configuration?

No. The CLI determines which supported sections have changed and pushes only those updates while checking for conflicts.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.