Me

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

FieldTypeDescriptionSupported Subfields
accountAccount!The user's account.
birthdayDateThe user's date of birth. Returned as YYYY-MM-DD.
country_codeStringThe user's country code.
created_atDateThe user's creation date. Returned as YYYY-MM-DD.
current_languageStringThe user's language.
custom_field_metas[CustomFieldMetas]The user profile custom fields metadata.description String
editable Boolean
field_type String
flagged Boolean
icon String
id String
position String
title String
custom_field_values[CustomFieldValue]The user profile custom field values.custom_field_meta_id String
value String
departmentDepartmentThe department(s) the user is a member of. Only available in versions 2026-04 and later.
emailString!The user's email.
enabledBoolean!Whether the user is enabled.
idID!The user's unique identifier.
is_adminBooleanWhether the user is an admin.
is_guestBooleanWhether the user is a guest.
is_pendingBooleanWhether the user hasn't confirmed their email yet.
is_verifiedBooleanWhether the user verified their email.
is_view_onlyBooleanWhether the user is a viewer.
join_dateDateThe date the user joined the account. Returned as YYYY-MM-DD.
last_activityDateThe last date and time the user was active. Returned as YYYY-MM-DDT00:00:00.
locationStringThe user's location.
mobile_phoneStringThe user's mobile phone number.
nameString!The user's name.
out_of_officeOutOfOfficeThe user's out-of-office status.active Boolean
disable_notifications Boolean
end_date Date
start_date Date
type String
phoneStringThe user's phone number.
photo_originalStringReturns the URL of the user's uploaded photo in its original size.
photo_smallStringReturns the URL of the user's uploaded photo in a small size (150x150 px).
photo_thumbStringReturns the URL of the user's uploaded photo in thumbnail size (100x100 px).
photo_thumb_smallStringReturns the URL of the user's uploaded photo in a small thumbnail size (50x50 px).
photo_tinyStringReturns the URL of the user's uploaded photo in tiny size (30x30 px).
sign_up_product_kindStringThe product the user first signed up to.
teams[Team]The user's teams.
time_zone_identifierStringThe user's timezone identifier.
titleStringThe user's title.
urlString!The user's profile URL.
utc_hours_diffIntThe user's UTC hours difference.