The country column represents a country. You can find the list of available countries here.

Check out our help center to learn more about the country column.

Reading the country column

You can return the data in a country column in two different formats. The text field will return the data as a simple string, and the value field will return the data as a JSON string.

Here is an example payload showing both fields:

  "text": "United States",
  "value": "{\"changed_at\":\"2022-07-21T12:00:00.000Z\",\"countryCode\":\"US\",\"countryName\":\"United States\"}"

Updating the country column

You can update a country column with a JSON string. Simple string updates are not supported.


To update a country column, send the ISO-2 country code (a two-letter code) and the country name.

Code example

mutation {
  change_multiple_column_values(item_id:11111, board_id:22222, column_values:"{\"country3\":{\"countryCode\":\"US\",\"countryName\":\"United States\"}}"){
fetch ("", {
  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: "{\"country3\": {\"countryCode\" : \"US\", \"countryName\": \"United States\"}}"
curl "" \
-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:\"{\\\"country3\\\" : {\\\"countryCode\\\" : \\\"US\\\", \\\"countryName\\\" : \\\"United States\\\"}}\"){name}}"}'

You can find the Postman request to change the country column here.

Clearing the country column

You can clear the country column using a change_multiple_column_values mutation like the one below.

mutation {
  change_multiple_column_values(item_id: 2973227073, board_id: 2973227049, column_values: "{\"country\" : {}}") {


Do you have questions?

Join our developer community! You can share your questions and learn from fellow users and product experts.

Don’t forget to search before opening a new topic!