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

Gets the API tokens of the currently authenticated user.

Authorizations

Responses

application/json

objectOptional

get

HTTPcURLJavaScriptPython

GET /api/v2/users/me/api-tokens HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
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

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

Authorizations

Body

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

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /api/v2/users/me/api-tokens HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
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

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.

Authorizations

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

application/json

objectOptional

delete

HTTPcURLJavaScriptPython

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

200

Successful response

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