Checking authentication...

Widgets

Create, read, update, delete, and reorder dashboard widgets

6 tools

Create Widget

Write

POST /v1/tools/podio/createWidget

Create a widget on an organization, space, app, or user. Widgets are small dashboard components like text blocks, task lists, calculations, tag clouds, etc. Use searchDocs for "podio_widgets" to see all widget types and their config options. Not all widget types work on all ref_types (e.g., "apps" widget only works on user). Returns the new widget_id.

Parameters

Name	Type	Required	Description
`ref_type`	string	required	Where to place the widget Values: organization, space, app, user
`ref_id`	number	required	ID of the organization, space, app, or user
`type`	string	required	Widget type. Use searchDocs "podio_widgets" for config details per type. Values: text, image, link, tag_cloud, calculation, tasks, events, profiles, apps, app_view, contacts, files, recent_items
`title`	string	required	Widget title displayed in the header
`config`	object	required	Type-specific configuration. Examples: text → { text: "..." }, calculation → { app_id, formula }, tag_cloud → { app_id? }, app_view → { app_id, view_id }, link → { links: [{ url, text }] }, image → { file_id }. See docs for full reference.

Request

curl -X POST https://api.syncello.io/v1/tools/podio/createWidget \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "ref_type": "organization",
  "ref_id": "123",
  "type": "text",
  "title": "example",
  "config": "..."
}'

Response

{
  "widget_id": 134000777,
  "type": "text",
  "title": "Pipeline Overview",
  "config": {
    "text": "Deals pipeline overview."
  },
  "ref": {
    "type": "space",
    "id": 7482910
  },
  "cols": 1,
  "rows": 1,
  "rights": [
    "view",
    "delete",
    "move",
    "update"
  ],
  "created_by": {
    "user_id": 1122334,
    "name": "Jane Doe"
  },
  "created_on": "2026-07-01 14:42:00"
}

Try It

Try it

Get Widget

Read Idempotent

POST /v1/tools/podio/getWidget

Get a single widget by ID. Returns the widget type, title, config, rights, and creation info.

Parameters

Name	Type	Required	Description
`widget_id`	number	required	The widget ID

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getWidget \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "widget_id": "123"
}'

Response

{
  "widget_id": 134000777,
  "type": "text",
  "title": "Pipeline Overview",
  "config": {
    "text": "Deals pipeline overview."
  },
  "ref": {
    "type": "space",
    "id": 7482910
  },
  "cols": 1,
  "rows": 1,
  "rights": [
    "view",
    "delete",
    "move",
    "update"
  ],
  "created_by": {
    "user_id": 1122334,
    "name": "Jane Doe"
  },
  "created_on": "2026-07-01 14:42:00"
}

Try It

Try it

Get Widgets

Read Idempotent

POST /v1/tools/podio/getWidgets

Get all widgets on an organization, space, app, or user. Returns an array of widgets with their type, title, config, data, and rights.

Parameters

Name	Type	Required	Description
`ref_type`	string	required	The reference type to get widgets for Values: organization, space, app, user
`ref_id`	number	required	ID of the organization, space, app, or user

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getWidgets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "ref_type": "organization",
  "ref_id": "123"
}'

Response

[
  {
    "widget_id": 134000777,
    "type": "text",
    "title": "Pipeline Overview",
    "config": {
      "text": "Deals pipeline overview."
    },
    "ref": {
      "type": "space",
      "id": 7482910
    },
    "cols": 1,
    "rows": 1,
    "rights": [
      "view",
      "delete",
      "move",
      "update"
    ]
  }
]

Try It

Try it

Update Widget

Write

POST /v1/tools/podio/updateWidget

Update a widget's title and/or configuration. Use getWidget or getWidgets first to see the current config.

Parameters

Name	Type	Required	Description
`widget_id`	number	required	The widget ID to update
`title`	string	optional	New widget title
`config`	object	optional	New type-specific configuration. See searchDocs "podio_widgets" for config details per widget type.

Request

curl -X POST https://api.syncello.io/v1/tools/podio/updateWidget \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "widget_id": "123"
}'

Response

{
  "widget_id": 134000777,
  "type": "text",
  "title": "Pipeline Notes",
  "config": {
    "text": "Deals pipeline overview."
  },
  "ref": {
    "type": "space",
    "id": 7482910
  },
  "cols": 1,
  "rows": 1,
  "rights": [
    "view",
    "delete",
    "move",
    "update"
  ],
  "created_by": {
    "user_id": 1122334,
    "name": "Jane Doe"
  },
  "created_on": "2026-07-01 14:42:00"
}

Try It

Try it

Delete Widget

Destructive

POST /v1/tools/podio/deleteWidget

Delete a widget by ID. This permanently removes the widget.

Parameters

Name	Type	Required	Description
`widget_id`	number	required	The widget ID to delete

Request

curl -X POST https://api.syncello.io/v1/tools/podio/deleteWidget \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "widget_id": "123"
}'

Response

{
  "status": "ok"
}

Try It

Try it

Update Widget Order

Write

POST /v1/tools/podio/updateWidgetOrder

Reorder widgets on an organization, space, app, or user. Pass widget IDs in the desired display order. Use getWidgets first to see current widgets and their IDs.

Parameters

Name	Type	Required	Description
`ref_type`	string	required	The reference type the widgets belong to Values: organization, space, app, user
`ref_id`	number	required	ID of the organization, space, app, or user
`widget_ids`	array	required	Widget IDs in the desired display order

Request

curl -X POST https://api.syncello.io/v1/tools/podio/updateWidgetOrder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "ref_type": "organization",
  "ref_id": "123",
  "widget_ids": "..."
}'

Response

{
  "status": "ok"
}