Credentials

Use these commands to manage credentials, including connections, keys, and credential requests, with the Make CLI.

---

Connections

Manage your connections.

---

make-cli connections list

List connections for a team.

Options

Option	Description	Required
--team-id	The team ID to list connections for	Yes
--type	Filter by connection type	No
--scopes	Scopes that are required on the requested connection types. Each connection type is a key in this object with an array of scopes as the value.	No

Example

make-cli connections list --team-id=5

---

make-cli connections get

Get details of a specific connection.

Arguments

Argument	Description	Required
<connection-id>	The connection ID to get. Can also be passed as --connection-id=<value>.	Yes

Example

make-cli connections get 2

---

make-cli connections create

Create a new connection.

Options

Option	Description	Required
--name	Human-readable name for the connection	Yes
--account-name	Connection type name (internal identifier)	Yes
--team-id	ID of the team to create the connection in	Yes
--data	Connection configuration data	No
--scope	OAuth scopes	No

Example

make-cli connections create \
  --name='My Google Connection' \
  --account-name=google \
  --team-id=5

---

make-cli connections update

Update a connection's configuration data.

Arguments

Argument	Description	Required
<connection-id>	The connection ID to update. Can also be passed as --connection-id=<value>.	Yes

Options

Option	Description	Required
--name	The new name for the connection	No
--data	Connection configuration data to update	No

Example

make-cli connections update 2 --name='Updated Connection'

---

make-cli connections verify

Verify if a connection is working correctly.

Arguments

Argument	Description	Required
<connection-id>	The connection ID to verify. Can also be passed as --connection-id=<value>.	Yes

Example

make-cli connections verify 2

---

make-cli connections delete

Delete a connection.

Arguments

Argument	Description	Required
<connection-id>	The connection ID to delete. Can also be passed as --connection-id=<value>.	Yes

Example

make-cli connections delete 2

---

Keys

Manage your keys.

---

make-cli keys list

List all keys for a team.

Options

Option	Description	Required
--team-id	The team ID to list keys for	Yes

Example

make-cli keys list --team-id=5

---

make-cli keys get

Get details of a specific key.

Arguments

Argument	Description	Required
<key-id>	The key ID to retrieve. Can also be passed as --key-id=<value>.	Yes

Example

make-cli keys get 1

---

make-cli keys create

Create a new key.

Options

Option	Description	Required
--team-id	The team ID where the key will be created	Yes
--name	Name of the key	Yes
--type-name	Type of the key	Yes
--parameters	Key-specific configuration parameters	Yes

Example

make-cli keys create \
  --team-id=5 \
  --name='My API Key' \
  --type-name=basicauth \
  --parameters='{"user":"admin","pass":"secret"}'

---

make-cli keys update

Update an existing key.

Arguments

Argument	Description	Required
<key-id>	The key ID to update. Can also be passed as --key-id=<value>.	Yes

Options

Option	Description	Required
--name	New name for the key	No
--parameters	Updated key-specific configuration parameters	No

Example

make-cli keys update 1 --name='My Updated Key'

---

make-cli keys delete

Delete a key.

Arguments

Argument	Description	Required
<key-id>	The key ID to delete. Can also be passed as --key-id=<value>.	Yes

Example

make-cli keys delete 1

---

Credential requests

Manage your credential requests.

---

make-cli credential-requests list

Retrieve a list of credential requests. Each request can contain multiple credentials (connections and API keys). Filter by team, user, provider, status, or name to find specific requests.

Options

Option	Description	Required
--team-id	Filter by team ID	Yes
--user-id	Filter by user ID	No
--make-provider-id	Filter by Make provider ID	No
--status	Filter by status	No
--name	Filter by name	No

Example

make-cli credential-requests list --team-id=5

---

make-cli credential-requests get

Retrieve detailed information about a specific credential request by its ID. Returns all associated credentials with their authorization status, provider configuration, user details, and authorization URLs for pending credentials. Use this to check the state of credentials within a request.

Arguments

Argument	Description	Required
<request-id>	The credential request ID to get details for. Can also be passed as --request-id=<value>.	Yes

Example

make-cli credential-requests get a07e16f2ad134bf49cf83a00aa95c0a5

---

make-cli credential-requests delete

Permanently delete a credential request and all associated credentials (connections and API keys) by ID. Any scenarios using connections from this request will lose access to the corresponding services. This action cannot be undone.

Arguments

Argument	Description	Required
<request-id>	The credential request ID to delete. Can also be passed as --request-id=<value>.	Yes

Example

make-cli credential-requests delete a07e16f2ad134bf49cf83a00aa95c0a5

---

make-cli credential-requests credential-decline

Decline a credential authorization request by ID, setting its status to "declined" and preventing it from being authorized. An optional reason can be provided to explain the decision. This operation is idempotent - declining an already-declined credential has no additional effect.

Arguments

Argument	Description	Required
<credential-id>	The credential ID to decline. Can also be passed as --credential-id=<value>.	Yes

Options

Option	Description	Required
--reason	Optional reason for declining	No

Example

make-cli credential-requests credential-decline b12f9e3c2d15af8 \
  --reason='Not required for this project'

---

make-cli credential-requests credential-delete

Delete a credential (e.g., revoke OAuth tokens or remove stored API keys) and reset its state to pending. Use this when a credential needs re-authorization with updated permissions, tokens have become stale, or you want to force re-authentication. After deletion, the credential can be authorized again through the normal flow.

Arguments

Argument	Description	Required
<credential-id>	The credential ID to delete. Can also be passed as --credential-id=<value>.	Yes

Example

make-cli credential-requests credential-delete b12f9e3c2d15af8

---

make-cli credential-requests create

Create a credential request for the currently authenticated user to set up connections and keys. This will return a URL where the user can authorize the credentials, so that they can be used in scenarios.

Options

Option	Description	Required
--name	Name of the Request which will be displayed to the End Users who open it.	No
--description	Description of the Request which will be displayed to the End Users who open it.	No
--team-id	Team ID	Yes
--credentials	Array of app/module selections to derive credentials from.	Yes

Example

make-cli credential-requests create \
  --name='Google Connection Request' \
  --team-id=5 \
  --credentials='[{"appName":"google","appModules":["*"]}]'

---

make-cli credential-requests create-by-credentials

Create a credential request for one or more connections (OAuth) and/or keys (API keys) by their type identifiers (e.g. "google", "slack", "apikeyauth"). Use this when you know the exact connection or key types needed. The response includes the created request, an array of credentials associated with the request, and a publicUri where the end-user must go to authorize the requested credentials. At least one connection or one key must be provided.

Options

Option	Description	Required
--name	Human-readable name for the credential request, displayed to the end-user who will authorize it.	No
--description	Instructions or context for the end-user, displayed on the authorization page.	No
--team-id	The numeric ID of the Make team where the connections/keys will be created once authorized.	Yes
--connections	Array of OAuth or basic-auth connections to request. Each item needs at least a "type" (e.g. "google", "slack", "github").	No
--keys	Array of API keys to request. Each item needs at least a "type" (e.g. "apikeyauth", "basicauth").	No

Example

make-cli credential-requests create-by-credentials \
  --name='My Credential Request' \
  --team-id=5 \
  --connections='[
    {
      "type": "google",
      "scope": [
        "https://www.googleapis.com/auth/drive"
      ]
    }
  ]' \
  --keys='[{"type":"apikeyauth"}]'

---

make-cli credential-requests extend-connection

Add new OAuth scopes to an existing connection. Use this when a connection exists but lacks the permissions (scopes) needed for a specific operation. Creates a credential request that the end-user must authorize via the returned publicUri to grant the additional scopes. Fails if all requested scopes are already present on the connection.

Arguments

Argument	Description	Required
<connection-id>	The numeric ID of an existing Make connection whose OAuth scopes need to be expanded. Can also be passed as --connection-id=<value>.	Yes

Options

Option	Description	Required
--scopes	One or more new OAuth scope strings to add to the connection. At least one scope must be new (not already granted).	Yes

Example

make-cli credential-requests extend-connection 2 \
  --scopes='["https://www.googleapis.com/auth/spreadsheets"]'