For the complete documentation index, see llms.txt. This page is also available as Markdown.

Me

The following endpoints retrieve data about the currently authenticated user.

Current user data

get
/users/me

Retrieves data about the authenticated user. Refer to the cols[] parameter accepted values to get more information about the currently authenticated user.

Required scopes
This endpoint requires the following scopes:
Authorizations
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.

Query parameters
includeInvitedOrgbooleanOptional

Set this parameter to true if you want to get also the user roles in organizations with pending invitation. The default value is false.

Example: {"value":true}
Responses
200

Successful response

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

Successful response

{
  "authUser": {
    "id": 1,
    "name": "Martin",
    "email": "admin@make.cloud",
    "language": "en",
    "timezoneId": 113,
    "localeId": 18,
    "countryId": 1,
    "features": {
      "allow_apps": true
    },
    "avatar": "https://secure.gravatar.com/avatar/6b1a74d20d925c12a73af32bf0dd7164.jpg?d=mm",
    "timezone": "Europe/Prague",
    "locale": "en",
    "emailNotifications": null,
    "hasAddedApp": false,
    "tfaStatus": 0
  }
}

Current user authorization

get
/users/me/current-authorization

Returns current authorization information for the authenticated user including scope and authentication method used.

Required scopes
This endpoint requires the following scopes:
Authorizations
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/current-authorization
GET /api/v2/users/me/current-authorization HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
200

Successful response

{
  "authorization": {
    "scope": [
      "read:user",
      "write:scenario"
    ],
    "authUsed": "token"
  }
}

Get onboarding survey status

get
/users/me/onboarding-survey

Returns whether the authenticated user has a pending onboarding survey. If the survey has been submitted, the response payload is included.

Required scopes
This endpoint requires the following scopes:
Authorizations
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

Survey status

application/json
pendingbooleanRequired

Whether the user still needs to complete the onboarding survey.

responseobjectOptional

The submitted survey response. Only present when pending is false and a response exists.

get/users/me/onboarding-survey
GET /api/v2/users/me/onboarding-survey HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
{
  "pending": true
}

Submit onboarding survey

post
/users/me/onboarding-survey

Submits the onboarding survey response for the authenticated user. Optionally pins preferred apps for the user in their organization.

Required scopes
This endpoint requires the following scopes:
Authorizations
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
survey_typestringRequired

The type of survey being submitted (e.g., self_serve, enterprise).

schema_versionnumberRequired

Version of the survey schema. Allows consumers to interpret the answers.

preferred_appsstring[]Optional

Optional list of native app package names to pin for the user. Apps that do not exist are reported as failed without blocking the submission.

Responses
200

Survey submitted successfully. Side effects (app pinning) are reported individually.

application/json
successbooleanOptional

Whether the core survey submission succeeded.

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

{
  "survey_type": "self_serve",
  "schema_version": 1,
  "answers": {
    "discovery_source": "search_engine",
    "technical_proficiency": "developer",
    "building_for": "team",
    "org_size": 1150,
    "team_department": "engineering"
  },
  "preferred_apps": [
    "slack",
    "gmail"
  ]
}
{
  "success": true,
  "result": {
    "ok": 1
  },
  "pinnedApps": [
    {
      "app": "slack",
      "success": true
    },
    {
      "app": "gmail",
      "success": true
    }
  ],
  "invitedUsers": []
}

User Organization invitations

get
/users/me/organization-invitations

Retrieves organization invitations of the currently authenticated user.

Required scopes
This endpoint requires the following scopes:
Authorizations
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/organization-invitations
GET /api/v2/users/me/organization-invitations HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
200

Successful response

{
  "userOrganizationInvitations": [
    {
      "hash": "e99ca895-4c54-4d13-b83a-8ab37c35f17a",
      "organizationId": 10,
      "organizationName": "Organization 10",
      "usersRoleId": 12,
      "invitation": "pending"
    },
    {
      "hash": "5cd8b8c3-cb5c-4bd8-8d31-4b92fcdc7768",
      "organizationId": 13,
      "organizationName": "Organization 13",
      "usersRoleId": 12,
      "invitation": "expired"
    }
  ]
}

Last updated