All monday.com users have a unique set of user details and different roles within an account. These details are available to access via the API, and the fastest way to do return details about the connected user is by querying the me object.

As a developer working with monday.com, it is important to familiarize yourself with the me API to gather user details. This document will walk you through the available queries to read the me object via the API.

Queries

Required scope: me:read

Querying me will return metadata about the user whose API key is being used. This method does not accept any arguments and returns an object.

You can only query me directly at the root, so it can't be nested within another query.

query {
  me {
    is_guest
    created_at
    name
    id
  }
}

let query = "query { me { is_guest created_at 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)));

Fields

You can use the following field(s) to specify what information your me query will return. Please note that some fields will have their own arguments.

📘

Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎