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
200
Successful response
application/json
get
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
200
Successful response
application/json
post
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
200
Successful response
application/json
delete
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"
}