Docs
Open Lodol
DocumentationIntegrationsAPI

Podio

App · 20 actions

Flexible work management with custom apps. Read your organizations, workspaces and apps; find, create, update and delete items; comment; and manage tasks.

Actions

ActionWhat it does
Add a commentComment on an item or a task.
Complete a taskMark a task as done.
Create a taskCreate a task, optionally attached to an item, workspace or app.
Create an itemAdd an item to an app.
Delete a taskDelete a task.
Delete an itemDelete an item.
Filter itemsList an app's items, optionally filtered and sorted.
Get a taskGet a task, with who it is assigned to and what it is attached to.
Get a workspaceGet a workspace's name, privacy, your role and who created it.
Get an appGet an app and its fields, with each field's external id (the key to use when creating or updating items) and a category field's options.
Get an itemGet an item with all its field values.
Get an item by its numberGet an item by its number within the app: the number at the end of its Podio address.
List appsList the apps in a workspace.
List commentsList the comments on an item or a task, oldest first.
List organizationsList the Podio organizations you belong to, each with its workspaces.
List tasksList tasks by who they are assigned to, what they are attached to, or their workspace, organization or app.
List workspacesList the workspaces in an organization.
Search an appSearch an app's items, tasks or files by text.
Update a taskChange a task's text, description, due date, assignee or privacy, or mark it done or not done.
Update an itemChange an item's field values, external id or tags.

Add a comment

Comment on an item or a task.

Inputs

Onref_typetextRequired
Whether the comment is on an item or a task.One of: item, task.
Item or task IDref_idtextRequired
The item_id or task_id the comment is on.
CommentvaluetextRequired
The comment's text.
External IDexternal_idtext
Your own id for it, to find it again later.
Invite mentioned peoplealert_invitetrue/false
Invite people @mentioned who are not in the workspace yet.Default: false.
Silentsilenttrue/false
Don't notify followers or show the change in the activity stream.Default: false.

Outputs

A comment.

comment_idtext
The comment's id.
created_byobject
A Podio user.
created_ontext
When it was posted (UTC).
external_idtext
The comment's external id.
file_countnumber
How many files are attached.
like_countnumber
How many likes it has.
ref_idtext
The id of what it is on.
ref_typetext
What it is on: item or task.
valuetext
The comment's text.
Example output
{
  "comment_id": "987654321",
  "created_by": {
    "name": "Ada Lovelace",
    "user_id": "1234567"
  },
  "created_on": "2026-10-15 10:00:00",
  "like_count": 0,
  "ref_id": "2398765432",
  "ref_type": "item",
  "value": "Looks good."
}

Complete a task

Mark a task as done. A recurring task's next occurrence is returned.

Inputs

Task IDtask_idtextRequired
The task's id, or its Podio address (podio.com/tasks/...).
Silentsilenttrue/false
Don't notify followers or show the change in the activity stream.Default: false.

Outputs

The completed task.

completedtrue/false
Always true.
recurring_task_idtext
The next occurrence, for a recurring task.
task_idtext
The task's id.
Example output
{
  "completed": true,
  "task_id": "198765432"
}

Create a task

Create a task, optionally attached to an item, workspace or app.

Inputs

TasktexttextRequired
What needs doing.
Descriptiondescriptiontext
More detail.
Duedue_ondate and time
When it is due.
Assign toresponsiblelist
Podio user ids or email addresses. Blank assigns it to you.
Attach toref_typetext
What kind of object to attach the task to.One of: item, space, app.
Attach to IDref_idtext
The id of the item, workspace or app.
Privateprivatetrue/false
Only the people on the task can see it.Default: false.
Labelslabelslist
Label names for the task.
External IDexternal_idtext
Your own id for it, to find it again later.
Silentsilenttrue/false
Don't notify followers or show the change in the activity stream.Default: false.

Outputs

A Podio task.

completed_ontext
When it was completed (UTC).
created_byobject
A Podio user.
created_ontext
When it was created (UTC).
descriptiontext
The task's description.
due_datetext
Due date, in the Podio user's timezone.
due_ontext
Due date and time in UTC.
due_timetext
Due time, in the Podio user's timezone.
external_idtext
The task's external id.
labelslist
The task's labels.
linktext
The task's address in Podio.
privatetrue/false
Whether only the people on it can see it.
refobject
What the task is attached to.
responsibleobject
A Podio user.
space_idtext
The workspace's id.
statustext
active, completed or deleted.
task_idtext
The task's id.
task_idslist
Every task created, when it was given to several people.
texttext
The task's text.
Example output
{
  "created_on": "2026-10-15 08:00:00",
  "due_on": "2026-10-20 15:00:00",
  "labels": [],
  "link": "https://podio.com/tasks/198765432",
  "ref": {
    "id": "2398765432",
    "title": "Website refresh",
    "type": "item"
  },
  "responsible": {
    "name": "Ada Lovelace",
    "user_id": "1234567"
  },
  "status": "active",
  "task_id": "198765432",
  "text": "Review the brief"
}

Create an item

Add an item to an app.

Inputs

Appapp_idtextRequired
The Podio app.
Fieldsfieldsobject
Values by field, filled from the app's fields. Leave one blank to leave it alone; give [] to clear it. A category takes its option, a relationship an item id, a date YYYY-MM-DD; any value may also be Podio JSON such as {"start_date": "2026-01-01"}.
External IDexternal_idtext
Your own id for it, to find it again later.
Tagstagslist
Tags for the item, as a list or comma-separated text.
Silentsilenttrue/false
Don't notify followers or show the change in the activity stream.Default: false.

Outputs

The created item.

app_idtext
The app's id.
item_idtext
The new item's id.
titletext
The new item's title.
Example output
{
  "app_id": "29876543",
  "item_id": "2398765432",
  "title": "Website refresh"
}

Delete a task

Delete a task.

Inputs

Task IDtask_idtextRequired
The task's id, or its Podio address (podio.com/tasks/...).
Silentsilenttrue/false
Don't notify followers or show the change in the activity stream.Default: false.

Outputs

The deleted task.

deletedtrue/false
Always true.
task_idtext
The deleted task's id.
Example output
{
  "deleted": true,
  "task_id": "198765432"
}

Delete an item

Delete an item.

Inputs

Item IDitem_idtextRequired
The item's id (item_id), as returned by 'Filter items' or 'Create an item'. This is not the number in the item's Podio address.
Silentsilenttrue/false
Don't notify followers or show the change in the activity stream.Default: false.

Outputs

The deleted item.

deletedtrue/false
Always true.
item_idtext
The deleted item's id.
Example output
{
  "deleted": true,
  "item_id": "2398765432"
}

Filter items

List an app's items, optionally filtered and sorted. Text fields cannot be filtered on; use 'Search an app' for those.

Inputs

Appapp_idtextRequired
The Podio app.
Filtersfiltersobject
Podio filters by field external id or key, e.g. {"status": [1], "external_id": "abc"}. A category takes option ids, a date {"from": "2026-01-01", "to": "2026-01-31"}.
Created on or aftercreated_fromdate
Only items created on or after this date.
Created on or beforecreated_todate
Only items created on or before this date.
Sort bysort_bytext
What to sort the items by.One of: created_on (Created on), last_edit_on (Last edit on), created_by (Created by), last_edit_by (Last edit by), app_item_id (App item id), item_id (Item id), activity, priority, title.
Newest or largest firstsort_desctrue/false
Sort in descending order.Default: false.
Limitlimitnumber
How many to return (default 30, at most 500).From 1 to 500.
Offsetoffsetnumber
How many results to skip, for paging.At least 0.

Outputs

The matching items.

countnumber
How many items were returned.
filterednumber
How many items match the filters.
has_moretrue/false
Whether more matching items exist past this page.
itemslist
The items.
totalnumber
How many items the app has.
Example output
{
  "count": 1,
  "filtered": 1,
  "has_more": false,
  "items": [
    {
      "app_id": "29876543",
      "app_item_id": "12",
      "app_name": "Projects",
      "comment_count": 1,
      "created_by": {
        "name": "Ada Lovelace",
        "user_id": "1234567"
      },
      "created_on": "2026-10-01 09:30:00",
      "fields": [
        {
          "external_id": "title",
          "field_id": "234567890",
          "label": "Title",
          "type": "text",
          "values": [
            {
              "value": "Website refresh"
            }
          ]
        }
      ],
      "file_count": 0,
      "item_id": "2398765432",
      "link": "https://podio.com/lodol/operations/apps/projects/items/12",
      "revision": 3,
      "tags": [
        "web"
      ],
      "title": "Website refresh",
      "values": {
        "title": "Website refresh"
      }
    }
  ],
  "total": 1
}

Get a task

Get a task, with who it is assigned to and what it is attached to.

Inputs

Task IDtask_idtextRequired
The task's id, or its Podio address (podio.com/tasks/...).

Outputs

A Podio task.

completed_ontext
When it was completed (UTC).
created_byobject
A Podio user.
created_ontext
When it was created (UTC).
descriptiontext
The task's description.
due_datetext
Due date, in the Podio user's timezone.
due_ontext
Due date and time in UTC.
due_timetext
Due time, in the Podio user's timezone.
external_idtext
The task's external id.
labelslist
The task's labels.
linktext
The task's address in Podio.
privatetrue/false
Whether only the people on it can see it.
refobject
What the task is attached to.
responsibleobject
A Podio user.
space_idtext
The workspace's id.
statustext
active, completed or deleted.
task_idtext
The task's id.
task_idslist
Every task created, when it was given to several people.
texttext
The task's text.
Example output
{
  "created_on": "2026-10-15 08:00:00",
  "due_on": "2026-10-20 15:00:00",
  "labels": [],
  "link": "https://podio.com/tasks/198765432",
  "ref": {
    "id": "2398765432",
    "title": "Website refresh",
    "type": "item"
  },
  "responsible": {
    "name": "Ada Lovelace",
    "user_id": "1234567"
  },
  "status": "active",
  "task_id": "198765432",
  "text": "Review the brief"
}

Get a workspace

Get a workspace's name, privacy, your role and who created it.

Inputs

Workspacespace_idtextRequired
The Podio workspace.

Outputs

A Podio workspace.

auto_jointrue/false
Whether new organization members join it automatically.
created_byobject
A Podio user.
created_ontext
When it was created (UTC).
nametext
The workspace's name.
org_idtext
The organization's id.
privacytext
open or closed.
roletext
Your role in it.
space_idtext
The workspace's id.
subscribedtrue/false
Whether you follow it.
typetext
regular or emp_network.
urltext
The workspace's address in Podio.
url_labeltext
The workspace's URL label.
Example output
{
  "name": "Operations",
  "org_id": "1122334",
  "privacy": "closed",
  "role": "admin",
  "space_id": "7654321",
  "type": "regular",
  "url": "https://podio.com/lodol/operations"
}

Get an app

Get an app and its fields, with each field's external id (the key to use when creating or updating items) and a category field's options.

Inputs

Appapp_idtextRequired
The Podio app.

Outputs

A Podio app.

app_idtext
The app's id.
descriptiontext
The app's description.
external_idtext
The app's external id.
fieldslist
The app's fields (only when getting one app).
icontext
The app's icon.
item_nametext
What one item is called.
nametext
The app's name.
space_idtext
The workspace's id.
statustext
active, inactive or deleted.
typetext
standard, meeting or contact.
Example output
{
  "app_id": "29876543",
  "fields": [
    {
      "external_id": "title",
      "field_id": "234567890",
      "label": "Title",
      "required": true,
      "status": "active",
      "type": "text"
    }
  ],
  "item_name": "Project",
  "name": "Projects",
  "space_id": "7654321",
  "status": "active",
  "type": "standard"
}

Get an item

Get an item with all its field values.

Inputs

Item IDitem_idtextRequired
The item's id (item_id), as returned by 'Filter items' or 'Create an item'. This is not the number in the item's Podio address.

Outputs

A Podio item.

app_idtext
The app's id.
app_item_idtext
The item's number within the app, as shown in Podio.
app_nametext
The app's name.
comment_countnumber
How many comments it has.
created_byobject
A Podio user.
created_ontext
When it was created (UTC).
external_idtext
The item's external id.
fieldslist
Each field with its raw values.
file_countnumber
How many files it has.
item_idtext
The item's id.
last_event_ontext
When it last changed (UTC).
linktext
The item's address in Podio.
revisionnumber
The item's current revision.
tagslist
The item's tags.
titletext
The item's title.
valuesobject
Each field's value by external id: a date's start, a category's text, a related item's title; a list when there are several.
Example output
{
  "app_id": "29876543",
  "app_item_id": "12",
  "app_name": "Projects",
  "comment_count": 1,
  "created_by": {
    "name": "Ada Lovelace",
    "user_id": "1234567"
  },
  "created_on": "2026-10-01 09:30:00",
  "fields": [
    {
      "external_id": "title",
      "field_id": "234567890",
      "label": "Title",
      "type": "text",
      "values": [
        {
          "value": "Website refresh"
        }
      ]
    }
  ],
  "file_count": 0,
  "item_id": "2398765432",
  "link": "https://podio.com/lodol/operations/apps/projects/items/12",
  "revision": 3,
  "tags": [
    "web"
  ],
  "title": "Website refresh",
  "values": {
    "title": "Website refresh"
  }
}

Get an item by its number

Get an item by its number within the app: the number at the end of its Podio address.

Inputs

Appapp_idtextRequired
The Podio app.
Item numberapp_item_idtextRequired
The item's number in the app, or its Podio address (.../items/12).

Outputs

A Podio item.

app_idtext
The app's id.
app_item_idtext
The item's number within the app, as shown in Podio.
app_nametext
The app's name.
comment_countnumber
How many comments it has.
created_byobject
A Podio user.
created_ontext
When it was created (UTC).
external_idtext
The item's external id.
fieldslist
Each field with its raw values.
file_countnumber
How many files it has.
item_idtext
The item's id.
last_event_ontext
When it last changed (UTC).
linktext
The item's address in Podio.
revisionnumber
The item's current revision.
tagslist
The item's tags.
titletext
The item's title.
valuesobject
Each field's value by external id: a date's start, a category's text, a related item's title; a list when there are several.
Example output
{
  "app_id": "29876543",
  "app_item_id": "12",
  "app_name": "Projects",
  "comment_count": 1,
  "created_by": {
    "name": "Ada Lovelace",
    "user_id": "1234567"
  },
  "created_on": "2026-10-01 09:30:00",
  "fields": [
    {
      "external_id": "title",
      "field_id": "234567890",
      "label": "Title",
      "type": "text",
      "values": [
        {
          "value": "Website refresh"
        }
      ]
    }
  ],
  "file_count": 0,
  "item_id": "2398765432",
  "link": "https://podio.com/lodol/operations/apps/projects/items/12",
  "revision": 3,
  "tags": [
    "web"
  ],
  "title": "Website refresh",
  "values": {
    "title": "Website refresh"
  }
}

List apps

List the apps in a workspace.

Inputs

Workspacespace_idtextRequired
The Podio workspace.
Include inactive appsinclude_inactivetrue/false
Also list apps that have been deactivated.Default: false.

Outputs

The apps.

appslist
The apps.
countnumber
How many apps were returned.
Example output
{
  "apps": [
    {
      "app_id": "29876543",
      "item_name": "Project",
      "name": "Projects",
      "space_id": "7654321",
      "status": "active",
      "type": "standard"
    }
  ],
  "count": 1
}

List comments

List the comments on an item or a task, oldest first.

Inputs

Onref_typetextRequired
Whether the comment is on an item or a task.One of: item, task.
Item or task IDref_idtextRequired
The item_id or task_id the comment is on.
Limitlimitnumber
How many to return (default 100, at most 100).From 1 to 100.
Offsetoffsetnumber
How many results to skip, for paging.At least 0.

Outputs

The comments.

commentslist
The comments.
countnumber
How many comments were returned.
Example output
{
  "comments": [
    {
      "comment_id": "987654321",
      "created_by": {
        "name": "Ada Lovelace",
        "user_id": "1234567"
      },
      "created_on": "2026-10-15 10:00:00",
      "like_count": 0,
      "ref_id": "2398765432",
      "ref_type": "item",
      "value": "Looks good."
    }
  ],
  "count": 1
}

List organizations

List the Podio organizations you belong to, each with its workspaces. Useful as a connection check.

Inputs

None.

Outputs

The organizations.

countnumber
How many organizations were returned.
organizationslist
The organizations.
Example output
{
  "count": 1,
  "organizations": [
    {
      "name": "Lodol",
      "org_id": "1122334",
      "spaces": [
        {
          "name": "Operations",
          "role": "admin",
          "space_id": "7654321",
          "type": "regular",
          "url": "https://podio.com/lodol/operations"
        }
      ],
      "status": "active",
      "type": "free"
    }
  ]
}

List tasks

List tasks by who they are assigned to, what they are attached to, or their workspace, organization or app. With no filter, lists your own tasks.

Inputs

Assigned toresponsibletext
A Podio user id; 0 for yourself.
Attached toreference_typetext
Only tasks attached to this kind of object.One of: item, space, app.
Attached to IDreference_idtext
The id of that item, workspace or app.
Workspacespace_idtext
Only tasks in this workspace.
Organizationorg_idtext
Only tasks in this organization.
Appapp_idtext
Only tasks on this app's items.
Completedcompletedtext
Only completed (Yes) or open (No) tasks. Blank lists both.One of: yes, no.
Due on or afterdue_fromdate
Only tasks due on or after this date.
Due on or beforedue_todate
Only tasks due on or before this date.
Sort bysort_bytext
What to sort the tasks by.One of: rank, created_on (Created on), completed_on (Completed on).
Descendingsort_desctrue/false
Sort in descending order.Default: false.
Limitlimitnumber
How many to return (default 20, at most 100).From 1 to 100.
Offsetoffsetnumber
How many results to skip, for paging.At least 0.

Outputs

The tasks.

countnumber
How many tasks were returned.
taskslist
The tasks.
Example output
{
  "count": 1,
  "tasks": [
    {
      "created_on": "2026-10-15 08:00:00",
      "due_on": "2026-10-20 15:00:00",
      "labels": [],
      "link": "https://podio.com/tasks/198765432",
      "ref": {
        "id": "2398765432",
        "title": "Website refresh",
        "type": "item"
      },
      "responsible": {
        "name": "Ada Lovelace",
        "user_id": "1234567"
      },
      "status": "active",
      "task_id": "198765432",
      "text": "Review the brief"
    }
  ]
}

List workspaces

List the workspaces in an organization.

Inputs

Organizationorg_idtextRequired
The Podio organization.

Outputs

The workspaces.

countnumber
How many workspaces were returned.
spaceslist
The workspaces.
Example output
{
  "count": 1,
  "spaces": [
    {
      "name": "Operations",
      "role": "admin",
      "space_id": "7654321",
      "type": "regular",
      "url": "https://podio.com/lodol/operations"
    }
  ]
}

Search an app

Search an app's items, tasks or files by text. Newly added items can take a little while to appear.

Inputs

Appapp_idtextRequired
The Podio app.
Search forquerytextRequired
The text to search for.
Onlyref_typetext
Only return this kind of result.One of: item, task, file.
Search insearch_fieldslist
Limit the search to these parts, e.g. title, text_values, email_values, tags, comments.
Limitlimitnumber
How many to return (default 20, at most 20).From 1 to 20.
Offsetoffsetnumber
How many results to skip, for paging.At least 0.

Outputs

The results.

countnumber
How many results were returned.
resultslist
The results.
Example output
{
  "count": 1,
  "results": [
    {
      "app_id": "29876543",
      "id": "2398765432",
      "title": "Website refresh",
      "type": "item"
    }
  ]
}

Update a task

Change a task's text, description, due date, assignee or privacy, or mark it done or not done. Only what you give is changed.

Inputs

Task IDtask_idtextRequired
The task's id, or its Podio address (podio.com/tasks/...).
Tasktexttext
The new text.
Descriptiondescriptiontext
The new description.
Due datedue_datedate
The new due date, in the Podio user's timezone.
Due timedue_timetime
The new due time, in the Podio user's timezone. Needs a due date.
Assign toresponsibletext
The Podio user id to assign it to.
Privateprivatetext
Make it private (Yes) or visible to the workspace (No). Blank leaves it as it is.One of: yes, no.
Completedcompletedtext
Mark it done (Yes) or not done (No). Blank leaves it as it is.One of: yes, no.

Outputs

A Podio task.

completed_ontext
When it was completed (UTC).
created_byobject
A Podio user.
created_ontext
When it was created (UTC).
descriptiontext
The task's description.
due_datetext
Due date, in the Podio user's timezone.
due_ontext
Due date and time in UTC.
due_timetext
Due time, in the Podio user's timezone.
external_idtext
The task's external id.
labelslist
The task's labels.
linktext
The task's address in Podio.
privatetrue/false
Whether only the people on it can see it.
refobject
What the task is attached to.
responsibleobject
A Podio user.
space_idtext
The workspace's id.
statustext
active, completed or deleted.
task_idtext
The task's id.
task_idslist
Every task created, when it was given to several people.
texttext
The task's text.
Example output
{
  "created_on": "2026-10-15 08:00:00",
  "due_on": "2026-10-20 15:00:00",
  "labels": [],
  "link": "https://podio.com/tasks/198765432",
  "ref": {
    "id": "2398765432",
    "title": "Website refresh",
    "type": "item"
  },
  "responsible": {
    "name": "Ada Lovelace",
    "user_id": "1234567"
  },
  "status": "active",
  "task_id": "198765432",
  "text": "Review the final brief"
}

Update an item

Change an item's field values, external id or tags. Only what you give is changed.

Inputs

Item IDitem_idtextRequired
The item's id (item_id), as returned by 'Filter items' or 'Create an item'. This is not the number in the item's Podio address.
Appapp_idtext
The item's app, to fill the Fields editor and check field names. Optional.
Fieldsfieldsobject
Values by field, filled from the app's fields. Leave one blank to leave it alone; give [] to clear it. A category takes its option, a relationship an item id, a date YYYY-MM-DD; any value may also be Podio JSON such as {"start_date": "2026-01-01"}.
External IDexternal_idtext
Your own id for it, to find it again later.
Tagstagslist
Replaces the item's tags.
Revisionrevisionnumber
Only update if the item is still at this revision (from 'Get an item'); otherwise the step fails.At least 0.
Silentsilenttrue/false
Don't notify followers or show the change in the activity stream.Default: false.

Outputs

The updated item.

item_idtext
The item's id.
revisionnumber
The item's new revision.
titletext
The item's title.
Example output
{
  "item_id": "2398765432",
  "revision": 4,
  "title": "Website refresh"
}

PM2.5 Open Data

Previous Page

PokéAPI

Next Page

On this page

ActionsAdd a commentComplete a taskCreate a taskCreate an itemDelete a taskDelete an itemFilter itemsGet a taskGet a workspaceGet an appGet an itemGet an item by its numberList appsList commentsList organizationsList tasksList workspacesSearch an appUpdate a taskUpdate an item