Credential Requests

The following endpoints allow you to manage credential requests for connections and keys. You can create requests, list them, view details, and manage individual credentials within requests.

Create new Credential Request

post

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/credential-requests/requests

Creates a new request for Credentials. Supports two flows - flow for new Make users and flow for existing Make users.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Body

application/json

namestring · max: 255Required

Name of the Request which will be displayed to the End Users who open it.

teamIdnumberRequired

ID of the Team the Credential Request should be bound to.

descriptionstring · max: 512Optional

Description of the Request which will be displayed to the End Users who open it.

providerone ofRequired

Provider information. Either an existing Make user ID or a new user to invite.

or

Responses

200

Credential Request has been created successfully.

application/json

post

/credential-requests/requests

HTTPcURLJavaScriptPython

POST /api/v2/credential-requests/requests HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 323

{
  "name": "Google Workspace Access",
  "teamId": 123,
  "description": "Request access to Google Workspace APIs for automation",
  "connections": [
    {
      "type": "google",
      "label": "Google Drive Connection",
      "description": "Access to Google Drive for file automation",
      "scope": [
        "drive.readonly",
        "drive.file"
      ]
    }
  ],
  "provider": {
    "providerMakeUserId": 456
  }
}

200

Credential Request has been created successfully.

{
  "request": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "organizationId": 1,
    "teamId": 123,
    "userId": 789,
    "name": "Google Workspace Access",
    "description": "Request access to Google Workspace APIs for automation",
    "externalProviderId": null,
    "makeProviderId": "456",
    "createdAt": "2025-12-12T10:00:00Z",
    "updatedAt": "2025-12-12T10:00:00Z",
    "expiresAt": "2026-01-12T10:00:00Z",
    "status": "pending",
    "shouldSendEmail": true,
    "emailSentAt": null
  }
}

Get Credential Request Detail

get

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/credential-requests/requests/{requestId}

Retrieves detail of a single Credential Request.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

requestIdstring · uuidRequired

ID of the Credential Request.

Query parameters

Responses

200

Credential Request detail.

application/json

get

/credential-requests/requests/{requestId}

HTTPcURLJavaScriptPython

GET /api/v2/credential-requests/requests/{requestId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Credential Request detail.

{
  "request": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "organizationId": 1,
    "teamId": 123,
    "userId": 789,
    "name": "Google Workspace Access",
    "description": "Request access to Google Workspace APIs for automation",
    "externalProviderId": null,
    "makeProviderId": "456",
    "createdAt": "2025-12-12T10:00:00Z",
    "updatedAt": "2025-12-12T10:00:00Z",
    "expiresAt": "2026-01-12T10:00:00Z",
    "status": "pending",
    "shouldSendEmail": true,
    "emailSentAt": null,
    "makeProvider": {
      "id": 456,
      "email": "[email protected]",
      "name": "John Doe"
    }
  }
}

List Credentials for Request

get

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/credential-requests/requests/{requestId}/credentials

Retrieves a list of Credentials associated with a Credential Request.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

requestIdstring · uuidRequired

ID of the Credential Request.

Query parameters

Responses

200

List of Credentials for the Request.

application/json

get

/credential-requests/requests/{requestId}/credentials

HTTPcURLJavaScriptPython

GET /api/v2/credential-requests/requests/{requestId}/credentials HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

List of Credentials for the Request.

{
  "credentials": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "component": "account",
      "type": "oauth",
      "name": "google",
      "label": "Google Drive Connection",
      "description": "Access to Google Drive for file automation",
      "scope": [
        "drive.readonly",
        "drive.file"
      ],
      "remoteId": null,
      "remoteScope": [],
      "tokenId": null,
      "createdAt": "2025-12-12T10:00:00Z",
      "updatedAt": "2025-12-12T10:00:00Z",
      "state": "pending",
      "declineReason": null,
      "appName": "google",
      "appModules": [],
      "appVersion": "1.0.0"
    }
  ]
}

Get Credential Detail

get

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/credential-requests/credentials/{credentialId}

Retrieves detail of a single Credential.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

credentialIdstring · uuidRequired

ID of the Credential.

Query parameters

Responses

200

Credential detail.

application/json

get

/credential-requests/credentials/{credentialId}

HTTPcURLJavaScriptPython

GET /api/v2/credential-requests/credentials/{credentialId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Credential detail.

{
  "credential": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "component": "account",
    "type": "oauth",
    "name": "google",
    "label": "Google Drive Connection",
    "description": "Access to Google Drive for file automation",
    "scope": [
      "drive.readonly",
      "drive.file"
    ],
    "remoteId": "12345",
    "remoteScope": [
      "drive.readonly",
      "drive.file"
    ],
    "tokenId": "770e8400-e29b-41d4-a716-446655440002",
    "createdAt": "2025-12-12T10:00:00Z",
    "updatedAt": "2025-12-12T10:30:00Z",
    "state": "authorized",
    "declineReason": null,
    "appName": "google",
    "appModules": [
      "Google Drive"
    ],
    "appVersion": "1.0.0"
  }
}

Decline Credential

post

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/credential-requests/credentials/{credentialId}/decline

Declines a credential by setting its state to declined and recording the reason. This endpoint is idempotent and can be used to update the decline reason of an already declined credential.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

credentialIdstring · uuidRequired

ID of the Credential.

Query parameters

Body

application/json

reasonstring · min: 1 · max: 2048Optional

The reason why the credential was declined. This will be visible to support teams and helps with troubleshooting.

Responses

200

Credential has been declined successfully.

application/json

post

/credential-requests/credentials/{credentialId}/decline

HTTPcURLJavaScriptPython

POST /api/v2/credential-requests/credentials/{credentialId}/decline HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "reason": "Unable to authorize - account does not have required permissions"
}

200

Credential has been declined successfully.

{
  "credential": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "component": "account",
    "type": "oauth",
    "name": "google",
    "label": "Google Drive Connection",
    "description": "Access to Google Drive for file automation",
    "scope": [
      "drive.readonly",
      "drive.file"
    ],
    "remoteId": null,
    "remoteScope": [],
    "tokenId": null,
    "createdAt": "2025-12-12T10:00:00Z",
    "updatedAt": "2025-12-12T11:00:00Z",
    "state": "declined",
    "declineReason": "Unable to authorize - account does not have required permissions",
    "appName": "google",
    "appModules": [],
    "appVersion": "1.0.0"
  }
}

Delete Remote Credential

post

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/credential-requests/credentials/{credentialId}/delete-remote

Deletes a credential from the remote platform (Make Web API) and resets its state to pending. The credential can then be re-created through the normal creation flow.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

credentialIdstring · uuidRequired

ID of the Credential.

Query parameters

Responses

200

Credential has been deleted from remote and reset to pending.

application/json

post

/credential-requests/credentials/{credentialId}/delete-remote

HTTPcURLJavaScriptPython

POST /api/v2/credential-requests/credentials/{credentialId}/delete-remote HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Credential has been deleted from remote and reset to pending.

{
  "credential": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "component": "account",
    "type": "oauth",
    "name": "google",
    "label": "Google Drive Connection",
    "description": "Access to Google Drive for file automation",
    "scope": [
      "drive.readonly",
      "drive.file"
    ],
    "remoteId": null,
    "remoteScope": [],
    "tokenId": null,
    "createdAt": "2025-12-12T10:00:00Z",
    "updatedAt": "2025-12-12T12:00:00Z",
    "state": "pending",
    "declineReason": null,
    "appName": "google",
    "appModules": [],
    "appVersion": "1.0.0"
  }
}

Create Action

post

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/credential-requests/actions/create

Creates a new Action for a Credential Creation. Either 'connection' or 'key' must be provided in the request body, but not both.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Body

application/json

Request body for creating a new action for credential creation.

namestring · max: 255Optional

Name of the Request which will be displayed to the End Users who open it.

descriptionstring · max: 512Optional

Description of the Request which will be displayed to the End Users who open it.

Responses

200

Credential Request to be used for completing the Action.

application/json

post

/credential-requests/actions/create

HTTPcURLJavaScriptPython

POST /api/v2/credential-requests/actions/create HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 274

{
  "name": "Google Drive Access",
  "description": "Action to create Google Drive connection",
  "connection": {
    "teamId": 123,
    "accountName": "google",
    "name": "My Google Drive",
    "scopes": [
      "drive.readonly",
      "drive.file"
    ],
    "appName": "google",
    "appModules": [
      "Google Drive"
    ],
    "appVersion": "1.0.0"
  }
}

Create connection actionCreate key action

200

Credential Request to be used for completing the Action.

{
  "request": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "organizationId": 1,
    "teamId": 123,
    "userId": 789,
    "name": "Google Drive Access",
    "description": "Action to create Google Drive connection",
    "externalProviderId": null,
    "makeProviderId": null,
    "createdAt": "2025-12-12T10:00:00Z",
    "updatedAt": "2025-12-12T10:00:00Z",
    "expiresAt": "2026-01-12T10:00:00Z",
    "status": "pending",
    "shouldSendEmail": false,
    "emailSentAt": null
  },
  "publicUri": "https://www.make.com/credential-requests/action/550e8400-e29b-41d4-a716-446655440000"
}