Use this tool to add a widget to an existing dashboard or board view. Widgets are the building blocks of monday.com dashboards — they visualize board data as charts, counters, calendars, timelines, Gantt charts, and list views.

🚧

Always call all_widgets_schema before creating a widget. Each widget type has its own required settings structure. Providing incorrect or incomplete settings will result in an error. Fetch the schema first, then construct your settings object to match the widget type you want to create.

The recommended workflow is:

1. Use all_widgets_schema to retrieve the JSON schema for all widget types.
2. Build a settings object that conforms to the schema for your chosen widget_kind.
3. Call create_widget with the dashboard ID and the validated settings.

Parameters

Example

Add a NUMBER (counter) widget to dashboard 37055164 that counts items from board 18394529013:

{
  "parent_container_id": "37055164",
  "parent_container_type": "DASHBOARD",
  "widget_kind": "NUMBER",
  "widget_name": "Item Count",
  "settings": {
    "counter_data": {
      "calculation_type": "count",
      "column_ids_per_board": {
        "18394529013": []
      },
      "counter_type": "sum"
    }
  }
}

The tool returned widget ID 666707475, confirming the widget was created on dashboard 37055164 with the name Item Count.

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  create_widget(
    board_id: 37055164
    widget_type: number
    name: "Item Count"
    settings: "{\"counter_data\":{\"calculation_type\":\"count\",\"counter_type\":\"sum\"}}"
  ) {
    id
    name
    type
  }
}

For full documentation, see Widgets.