Users > API Tokens

The following endpoints manage and retrieve data about the API tokens assigned to the currently authenticated user.

List users API tokens

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

/users/me/api-tokens

Gets the API tokens of the currently authenticated user.

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.

Responses

200

Successful response

application/json

get

/users/me/api-tokens

HTTPcURLJavaScriptPython

GET /api/v2/users/me/api-tokens HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "apiTokens": [
    {
      "token": "2544847b-****-****-****-************",
      "scope": [
        "apps:write"
      ],
      "created": "2019-11-05T09:22:31.249Z",
      "label": "token dva write"
    },
    {
      "token": "40aff759-****-****-****-************",
      "scope": [
        "apps:read"
      ],
      "created": "2019-11-05T09:22:22.615Z",
      "label": "token one read"
    }
  ]
}

Create new API token

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

/users/me/api-tokens

Create a new API token for the currently authenticated user. Specify the API token scopes in the scope array parameter.

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

labelstringRequired

The API token label visible in the Make user profile.

scopestring · uri[]Required

The API scopes provided to the API token. The API scopes determine the scope of operations that you can do with the API token.

Check the list of all existing Make API scopes with the API call GET /enums/user-api-tokes-scopes.

Responses

200

Successful response

application/json

post

/users/me/api-tokens

HTTPcURLJavaScriptPython

POST /api/v2/users/me/api-tokens HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "label": "example token",
  "scope": [
    "apps:read",
    "apps:write"
  ]
}

200

Successful response

{
  "apiToken": {
    "token": "7615989d-d213-48dc-b625-27133ae3f1a8",
    "scope": [
      "apps:read",
      "apps:write"
    ],
    "created": "2019-11-06T14:37:51.493Z",
    "label": "example token"
  }
}

Delete API token

delete

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

/users/me/api-tokens/{timestamp}

Deletes currently authenticated user's API token with the specified creation timestamp. Get the API token creation timestamp with the API call GET /users/me/api-tokens in the parameter value created. Copy the timestamp string to the API call path to delete the API token.

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

timestampstring · date-timeRequired

The timestamp of the moment when you created the API key in the ISO 8601 compliant format.

Example: 2020-03-27T05:53:27.368Z

Responses

200

Successful response

application/json

delete

/users/me/api-tokens/{timestamp}

HTTPcURLJavaScriptPython

DELETE /api/v2/users/me/api-tokens/{timestamp} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "apiToken": "2020-03-27T05:53:27.368Z"
}