Phone

The phone column stores a phone number with a relevant country code.

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

You can update a phone column with both a simple string and a JSON string.

Simple strings

To update a phone column value, send the phone number (digits only including the country code) and the ISO-2 country code (a two letter code) as a string. Make sure to separate the phone number and country short code with a space.

You can see the list of available countries here.

For example: "19175998722 US".

JSON

To update a phone column send the phone number (digits only) in the "phone" field, and the ISO-2 country code (a two letter code) in the "countryShortName" field.

You can see the list of available countries here.

For example: "{"phone":"11231234567","countryShortName":"US"}".

🚧
The 2-letter country code must be sent in capital letters, otherwise you will receive an error.

Code example

mutation {
  change_multiple_column_values(item_id:11111, board_id:22222, column_values: "{\"phone\" : {\"phone\" : \"11231234567\", \"countryShortName\" : \"US\"}}") {
    id
  }
}

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: "{\"phone\" : {\"phone\" : \"11231234567\", \"countryShortName\" : \"US\"}}"
    })
  })
})

curl "https://api.monday.com/v2" \
-X POST \
-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:\"{\\\"phone\\\" : {\\\"phone\\\" : \\\"11231234567\\\", \\\"countryShortName\\\" : \\\"US\\\"}}\"){name}}"}'