Learn how to use API tokens to read user data through the platform API
All monday.com users have a unique set of user details and different roles within an account. The me query returns the user associated with the API token being used, making it useful for identifying the current user's identity, permissions, and profile information.
Queries
Get me
- Required scope:
me:read - Returns an object containing metadata about the user whose API key is being used
- Can only be queried directly at the root; can't be nested within another query
query {
me {
is_guest
created_at
name
id
}
}const GET_ME = "query { me { is_guest created_at name id } }";
const seamlessApiClient = new SeamlessApiClient("2025-04");
const response = await seamlessApiClient.request(GET_ME);Fields
| Field | Type | Description | Supported Subfields |
|---|---|---|---|
| account | Account! | The user's account. | |
| birthday | Date | The user's date of birth. Returned as YYYY-MM-DD. | |
| country_code | String | The user's country code. | |
| created_at | Date | The user's creation date. Returned as YYYY-MM-DD. | |
| current_language | String | The user's language. | |
| custom_field_metas | [CustomFieldMetas] | The user profile custom fields metadata. | description Stringeditable Booleanfield_type Stringflagged Booleanicon Stringid Stringposition Stringtitle String |
| custom_field_values | [CustomFieldValue] | The user profile custom field values. | custom_field_meta_id Stringvalue String |
| department | Department | The department(s) the user is a member of. Only available in versions 2026-04 and later. | |
String! | The user's email. | ||
| enabled | Boolean! | Whether the user is enabled. | |
| id | ID! | The user's unique identifier. | |
| is_admin | Boolean | Whether the user is an admin. | |
| is_guest | Boolean | Whether the user is a guest. | |
| is_pending | Boolean | Whether the user hasn't confirmed their email yet. | |
| is_verified | Boolean | Whether the user verified their email. | |
| is_view_only | Boolean | Whether the user is a viewer. | |
| join_date | Date | The date the user joined the account. Returned as YYYY-MM-DD. | |
| last_activity | Date | The last date and time the user was active. Returned as YYYY-MM-DDT00:00:00. | |
| location | String | The user's location. | |
| mobile_phone | String | The user's mobile phone number. | |
| name | String! | The user's name. | |
| out_of_office | OutOfOffice | The user's out-of-office status. | active Booleandisable_notifications Booleanend_date Datestart_date Datetype String |
| phone | String | The user's phone number. | |
| photo_original | String | Returns the URL of the user's uploaded photo in its original size. | |
| photo_small | String | Returns the URL of the user's uploaded photo in a small size (150x150 px). | |
| photo_thumb | String | Returns the URL of the user's uploaded photo in thumbnail size (100x100 px). | |
| photo_thumb_small | String | Returns the URL of the user's uploaded photo in a small thumbnail size (50x50 px). | |
| photo_tiny | String | Returns the URL of the user's uploaded photo in tiny size (30x30 px). | |
| sign_up_product_kind | String | The product the user first signed up to. | |
| teams | [Team] | The user's teams. | |
| time_zone_identifier | String | The user's timezone identifier. | |
| title | String | The user's title. | |
| url | String! | The user's profile URL. | |
| utc_hours_diff | Int | The user's UTC hours difference. |
