The connect (item link) column links an item on the board with item(s) on different board(s).

Check out our help center to learn more about this column: [The Connect Column}(

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



Currently, to connect items using our API, the board(s) these items reside in (board B) must be connect to the current board (board A) manually.

If this step is not completed, an error will be raised.


To update a connect column, send the item IDs to be linked as an array. If the items sent do not belong to the board(s) that are connected, an exception will be raised.

Code example

mutation {
  change_multiple_column_values(item_id:11111, board_id:22222, column_values: "{\"connect_boards2\" : {\"item_ids\" : [12345, 23456, 34567]}}") {
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: "{\"connect_boards2\": {\"item_ids\": [12345, 23456, 34567]}}"
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:\"{\\\"connect_boards2\\\" : {\\\"item_ids\\\" : [12345, 23456, 34567]}}\"){name}}"}'

Did this page help you?