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

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/users/me/api-tokens' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "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"
    }
  ]
}

Successful response

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

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://eu1.make.com/api/v2/users/me/api-tokens' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "label": "example token",
    "scope": [
      "apps:read",
      "apps:write"
    ]
  }'

200

200

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

Successful response

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

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://eu1.make.com/api/v2/users/me/api-tokens/{timestamp}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

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

Successful response