Authenticate the Make CLI

Before you can run commands, you must connect the Make CLI to your Make account. Your authentication options are the login wizard, environment variables, or per-command options.

Login wizard (recommended)

The login wizard saves your credentials locally, so you don't have to pass them with every command.

To start the wizard, run:

make-cli login

The wizard guides you through the following steps:

1. Select your zone (for example, EU1).

2. If you don't have a Make API key, create one in the Make API key page that opens in your browser.

3. Enter your API key.

Your credentials are saved to the following location, depending on your operating system:

Operating system	Credentials location
macOS / Linux	~/.config/make-cli/config.json
Windows	%APPDATA%\make-cli\config.json

Once authenticated, all commands work without extra options.

Authentication status

To confirm which account you're signed in to, run:

make-cli whoami

Log out

To remove your saved credentials, run:

make-cli logout

Environment variables

To set your API key and zone as environment variables:

export MAKE_API_KEY="your-api-key"
export MAKE_ZONE="MAKE_ZONE"

Per-command options

To pass your credentials directly with each command using the --api-key and --zone options:

make-cli --api-key your-api-key --zone MAKE_ZONE scenarios list --team-id 1

Authentication priority

If you use more than one authentication method, the Make CLI resolves credentials in the following order:

1. Per-command options

2. Environment variables

3. Saved credentials from the login wizard