This section refers to the multiple-person/people column. If you are trying to update the person column, check out the person column instead.

The people column represents a simple true or false value on a board.

Check out our help center to learn more about the column: The People Column.

You can update a people column with both a simple string or a JSON string.

Simple strings

To update a people column, send a string of people you want to add to the column separated by a comma (","). Each number in the string should represent the ID of the person to be added.

For example: "4616627, 4616435, 4616912".


To update a people column, send an array with the people or teams you want to add to the column. Each item in the array should include an int representing the ID of the person/team, and a string signifying whether the item is a person or a team.

For example: "{"personsAndTeams":[{"id":4616627,"kind":"person"},{"id":4616666,"kind":"person"},{"id":51166,"kind":"team"}]}".

Code example

mutation {
  change_multiple_column_values(item_id:11111, board_id:22222, column_values: "{\"people_2\" : {\"personsAndTeams\":[{\"id\":4616627,\"kind\":\"person\"},{\"id\":4616666,\"kind\":\"person\"},{\"id\":51166,\"kind\":\"team\"}]}}") {
fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY'
  body: JSON.stringify({
    query : "mutation ($myBoardId:Int!, $myItemId:Int!, $myColumnValues:JSON!) { change_multiple_column_values(item_id:$myItemId, board_id:$myBoardId, column_values: $myColumnValues) { id }}",
    variables : JSON.stringify({
      myBoardId: YOUR_BOARD_ID,
      myItemId: YOUR_ITEM_ID,
      myColumnValues:"{\"people_2\": {\"personAndTeams\": [{\"id\": 4616627, \"kind\": \"person\"}, {\"id\": 4616666, \"kind\": \"person\"}, {\"id\": 51166, \"kind\": \"team\"}]}}"
curl "https://api.monday.com/v2" \
-H "Content-Type:application/json" \
-H "Authorization:MY_API_KEY" \
-d '{"query":"mutation{change_multiple_column_values(item_id:162169283, board_id:162169280, column_values:\"{\\\"people_2\\\" : {\\\"personsAndTeams\\\":[{\\\"id\\\":4616627,\\\"kind\\\":\\\"person\\\"},{\\\"id\\\":4616666,\\\"kind\\\":\\\"person\\\"},{\\\"id\\\":51166,\\\"kind\\\":\\\"team\\\"}]}}\"){name}}"}'

Did this page help you?