Required scope: users:read

Every user in monday.com is a part of an account (i.e an organization) and could be a member or a guest in that account.

Querying users returns one or multiple users.

To learn more about users, check out our resource here.

query {
    users (ids: [3332456, 8375782, 9304582]) {
        created_at
        email
        account {
            name
            id
        }
    }
}
let query = "query { users (ids: [3332456, 8375782, 9304582]) { created_at email account { name id}}";

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     query : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));
curl --location --request POST 'https://api.monday.com/v2' \
--header 'Authorization: YourSuperSecretAPIkey' \
--header 'Content-Type: application/json' \
--data-raw '{"query": "query { users (ids: [3332456, 8375782, 9304582]) { created_at email account { name id}}"}'
}}'

Arguments

The following users() arguments can reduce the number of users returned.

ArgumentDescription
ids [Int]A list of users' unique identifiers.
kind UserKindThe kind to search users by (all / non_guests / guests / non_pending).
newest_first BooleanGet the recently created users at the top of the list.
limit IntNumber of users to get.

Fields

Fields are used to return specific properties in an object. The following fields will determine what information is returned from your users() query.

FieldField Description
account !AccountThe user's account.
birthday DateThe user's date of birth, as set in their profile and returned as YYYY-MM-DD.
country_code StringThe user's country code.
created_at DateWhen the user profile was created, returned as YYYY-MM-DD.
join_date DateThe date the user joined the account and returned as YYYY-MM-DD.
email !StringThe user's email.
enabled !BooleanWill return true if the user is enabled.
id !IntThe user's unique identifier.
is_admin BooleanWill return true if the user is an Admin;
is_guest BooleanWill return true if the user is a guest.
is_pending BooleanWill return true if the user didn't confirm their email yet.
is_view_only BooleanWill return true if the user is a Viewer.
is_verified BooleanWill return "true" if the user confirmed their profile via the confirmation email.
location StringThe user's location.
mobile_phone StringThe user's mobile phone number.
name !StringThe user's name.
phone StringThe user's phone number.
photo_original StringWill return the URL of the user's uploaded photo in its original size.
photo_small StringWill return the URL of the user's uploaded photo in a small size (150x150 px).
photo_thumb StringWill return the URL of the user's uploaded photo in thumbnail size (100x100 px).
photo_thumb_small String).Will return the URL of the user's uploaded photo a small thumbnail size (50x50 px
photo_tiny StringWill return the URL of the user's uploaded photo in tiny size (30x30).
teams [Team]The teams the user is a member in. Also includes the following argument:

ids [Int]
A list of the teams' identifiers to reference.
time_zone_identifier StringThe user's timezone identifier.
title StringThe user's title.
url !StringThe user's profile URL.
utc_hours_diff IntThe user’s UTC hours difference.

Did this page help you?