> For the complete documentation index, see [llms.txt](https://developers.make.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.make.com/api-documentation/api-reference/users/me.md).

# Me

The following endpoints retrieve data about the currently authenticated user.

## Current user data

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

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Users / Me","description":"The following endpoints retrieve data about the currently authenticated user."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["organizations:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/users/me":{"get":{"tags":["Users / Me"],"summary":"Current user data","description":"Retrieves data about the authenticated user. Refer to the `cols[]` parameter accepted values to get more information about the currently authenticated user.","parameters":[{"name":"includeInvitedOrg","description":"Set this parameter to `true` if you want to get also the user roles in organizations with pending invitation. The default value is `false`.","in":"query","schema":{"type":"boolean"}},{"name":"cols[]","in":"query","schema":{"type":"array","items":{"type":"string","enum":["id","name","email","language","timezoneId","localeId","countryId","features","avatar","timezone","locale","emailNotifications","usersAdminsRoleId","userOrganizationRoles","userTeamRoles","forceSetPassword","hasPassword","tfaEnabled","tfaStatus","isAffiliatePartner","hasAddedApp","supportEligible"]}},"description":"Specifies columns that are returned in the response. Use the `cols[]` parameter for every column that you want to return in the response. For example `GET /endpoint?cols[]=key1&cols[]=key2` to get both `key1` and `key2` columns in the response.\n\n[Check the \"Filtering\" section for a full example.](/api-documentation/pagination-sorting-filtering/filtering)\n"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"authUser":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"language":{"type":"string"},"timezoneId":{"type":"integer"},"localeId":{"type":"integer"},"countryId":{"type":"integer"},"features":{"type":"object","properties":{"allow_apps":{"type":"boolean"}}},"avatar":{"type":"string","format":"uri"},"lastLogin":{"type":"string","format":"date-time"},"tfaStatus":{"type":"integer","nullable":true,"enum":[0,1,2],"description":"Two-factor authentication status:\n- 0: No TFA set\n- 1: TFA active (authenticator app)\n- 2: External authentication (Social SSO)\n\nIt is only supported on Make's public cloud instances.\n"},"supportEligible":{"type":"boolean","description":"Whether the user is eligible for contact support. False if all user's organizations are on Free plan and account is older than 90 days."},"userTeamIds":{"type":"array","nullable":true,"description":"IDs of teams the user belongs to within the organization. Only returned when explicitly requested via cols[]=userTeamIds and organizationId is provided.","items":{"type":"integer"}},"privateSpace":{"nullable":true,"description":"The user's personal private space in the organization. Only returned when explicitly requested via cols[]=privateSpace with organizationId on a public instance.","type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"globalAgentsEnabled":{"type":"boolean"},"type":{"type":"string","enum":["personal"]},"operationsLimit":{"type":"integer","nullable":true},"transferLimit":{"type":"bigint","nullable":true},"consumedOperations":{"type":"integer","nullable":true},"consumedTransfer":{"type":"bigint","nullable":true},"isPaused":{"type":"boolean","nullable":true},"consumedCenticredits":{"type":"integer","nullable":true}}}}}}}}}}}}}}}
```

## Current user authorization

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

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Users / Me","description":"The following endpoints retrieve data about the currently authenticated user."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["organizations:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/users/me/current-authorization":{"get":{"tags":["Users / Me"],"summary":"Current user authorization","description":"Returns current authorization information for the authenticated user including scope and authentication method used.","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"authorization":{"type":"object","properties":{"scope":{"type":"array","items":{"type":"string"},"description":"The scopes for the authenticated user"},"authUsed":{"type":"string","description":"The authentication method that was used"}}}}}}}}}}}}}
```

## Get onboarding survey status

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

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Users / Me","description":"The following endpoints retrieve data about the currently authenticated user."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["user:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/users/me/onboarding-survey":{"get":{"tags":["Users / Me"],"summary":"Get onboarding survey status","description":"Returns whether the authenticated user has a pending onboarding survey. If the survey has been submitted, the response payload is included.","responses":{"200":{"description":"Survey status","content":{"application/json":{"schema":{"type":"object","properties":{"pending":{"type":"boolean","description":"Whether the user still needs to complete the onboarding survey."},"response":{"type":"object","description":"The submitted survey response. Only present when `pending` is `false` and a response exists."}},"required":["pending"]}}}},"401":{"description":"Unauthorized — user is not authenticated."}}}}}}
```

## Submit onboarding survey

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

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Users / Me","description":"The following endpoints retrieve data about the currently authenticated user."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["user:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/users/me/onboarding-survey":{"post":{"tags":["Users / Me"],"summary":"Submit onboarding survey","description":"Submits the onboarding survey response for the authenticated user. Optionally pins preferred apps for the user in their organization.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"survey_type":{"type":"string","description":"The type of survey being submitted (e.g., `self_serve`, `enterprise`)."},"schema_version":{"type":"number","description":"Version of the survey schema. Allows consumers to interpret the answers."},"answers":{"type":"object","description":"The user's answers to the survey questions, keyed by question name.","additionalProperties":true},"preferred_apps":{"type":"array","description":"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.","items":{"type":"string"}},"team_invite":{"type":"object","description":"Optional team members to invite during onboarding. Invites are best-effort and do not block the submission.","properties":{"emails":{"type":"array","description":"Email addresses to invite as regular organization members.","items":{"type":"string","format":"email"}},"sso":{"type":"array","description":"Email addresses to invite via the organization's SSO provider.","items":{"type":"string","format":"email"}}}}},"required":["survey_type","schema_version","answers"]}}}},"responses":{"200":{"description":"Survey submitted successfully. Side effects (app pinning) are reported individually.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the core survey submission succeeded."},"result":{"type":"object","description":"The SWARM response from HQ confirming the submission.","properties":{"ok":{"type":"number","enum":[1]}}},"pinnedApps":{"type":"array","description":"Result of each app pin attempt. Empty array if no `preferred_apps` were provided.","items":{"type":"object","properties":{"app":{"type":"string","description":"The app package name."},"success":{"type":"boolean","description":"Whether the pin succeeded."},"error":{"type":"string","description":"Error message if the pin failed. Only present when `success` is `false`."}}}},"invitedUsers":{"type":"array","description":"Result of each team-invite attempt. Empty array if no `team_invite` was provided. Invites are best-effort, so per-invitee failures do not fail the submission.","items":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"The invitee's email address."},"success":{"type":"boolean","description":"Whether the invite succeeded."},"error":{"type":"string","description":"Error reason if the invite failed. Only present when `success` is `false`."}}}}}}}}},"400":{"description":"Validation error — missing required fields (`survey_type`, `schema_version`, or `answers`)."},"401":{"description":"Unauthorized — user is not authenticated."}}}}}}
```

## User Organization invitations

> Retrieves organization invitations of the currently authenticated user.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Users / Me","description":"The following endpoints retrieve data about the currently authenticated user."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["user:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/users/me/organization-invitations":{"get":{"tags":["Users / Me"],"summary":"User Organization invitations","description":"Retrieves organization invitations of the currently authenticated user.","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"userOrganizationInvitations":{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"invitation":{"type":"string"},"usersRoleId":{"type":"integer"},"organizationId":{"type":"integer"},"organizationName":{"type":"string"},"zone":{"type":"string"}}}}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.make.com/api-documentation/api-reference/users/me.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.