Skip to main content
Podio logo
  • Category: project management
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 143
  • Triggers: 0
  • Slug: PODIO
  • Version: 00000000_00

Tools

Slug: PODIO_ACTIVATE_APPActivate a deactivated Podio app, restoring it to the app navigator and allowing new item creation.

Input Parameters

integer
required
ID of the app to activate.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_ADD_NEW_APPCreate a Podio app on a space with its configuration and fields.

Input Parameters

object
required
Configuration of the new app.
array
Fields to add to the app.
boolean
Whether to avoid stream bumps and notifications. Defaults to false.
integer
required
ID of the space on which to place the app.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_ADD_NEW_APP_FIELDAdd a field to a Podio app.

Input Parameters

string
required
Podio field type.
integer
required
ID of the app receiving the field.
object
required
Configuration of the new field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_ADD_NEW_ORGANIZATIONCreate a new Podio organization. This administrative action creates a new organization visible to its members.

Input Parameters

Optional file ID for the organization logo.
string
required
Name of the new organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_ARCHIVE_SPACEArchive a Podio space, hiding it from navigation without deleting its contents.

Input Parameters

integer
required
ID of the space to archive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_ASSIGN_TASKAssign a Podio task to a user, or remove its responsible user.

Input Parameters

boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio task ID to assign.
string
required
User ID to make responsible, or null to leave the task unassigned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_BULK_DELETE_ITEMSPermanently delete explicitly selected or filter-matched items from an app and remove them from all views. Deleted data cannot be retrieved.

Input Parameters

integer
required
Podio app ID containing the items.
boolean
Whether to suppress stream bumps and notifications.
object
Filters selecting items to delete; ignored when item_ids is set.
integer
Saved view whose matching items should be deleted; ignored when item_ids is set.
array
Explicit item IDs to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CALCULATE_ITEMSCalculate an aggregation over items in a Podio app, optionally grouped and filtered.

Input Parameters

integer
Maximum number of grouped results.
integer
required
Podio app ID whose items should be calculated.
array
Optional calculation filters with key and values.
array
Ordered formula parts with type and value.
array
Optional field or revision groupings.
string ("sum" | "average" | "count" | "mininum" | "maximum")
required
Aggregation to perform; Podio documents ‘mininum’ with this spelling.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CLONE_ITEMCreate a new item in the same app with values identical to the selected item.

Input Parameters

boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio item ID to clone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_COMPLETE_TASKMark a Podio task complete. Completing a recurring task may create its next task and return that task’s ID.

Input Parameters

boolean
Whether Podio hooks should run for this change.
boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio task ID to change.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CREATE_COMMENTAdd a comment to a Podio object, optionally attaching uploaded files or an embedded link. Setting alert_invite to true may also invite mentioned users who lack access to the workspace.

Input Parameters

boolean
Whether Podio hooks should run for this change.
string
required
Comment text.
boolean
If true, do not bump the object in the stream or generate notifications.
integer
Existing Podio embed ID to attach.
array
Temporary uploaded file IDs to attach.
string
URL to attach as an embedded link.
string
External-system identifier for the comment.
boolean
Whether mentioned users may be invited to the workspace when they need access to the commented object.
integer
required
ID of the Podio object to comment on.
string
required
Podio reference type of the object to comment on, such as item or task. Podio does not publish an exhaustive list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CREATE_ITEMCreate an item in a Podio app using field IDs or external IDs, with optional files, tags, reminder, recurrence, and reference.

Input Parameters

object
Optional reference to another Podio item.
boolean
Whether Podio hooks should run for this change.
array
Tags to add to the item.
integer
required
Podio app ID whose field definitions govern the new item.
object
required
Map of app field ID or external ID to its Podio field value. Values may be scalars, objects, or lists in the shape required by that field type.
boolean
If true, do not bump the item in the stream or generate notifications.
array
Temporary uploaded file IDs to attach.
object
Optional reminder configuration.
object
Optional recurrence configuration.
string
External-system identifier for the item.
integer
Linked account to use for a meeting item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CREATE_ORGANIZATION_APP_STORE_PROFILEAdministratively create an app-store profile for a Podio organization when one does not already exist.

Input Parameters

object
required
App-store profile fields using Podio contact-area field names and values. These are sent as the top-level request body.
integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CREATE_REFERENCED_TASKCreate a Podio task attached through the reference-specific task route.

Input Parameters

boolean
Whether Podio hooks should run for this change.
string
required
Task title text.
string
UTC due date and time.
array
Label names to apply.
integer
required
ID of the Podio object to reference.
boolean
Whether to suppress stream bumps and notifications.
boolean
Whether the task is private.
string
Local due date.
string
Local due time.
array
File IDs to attach.
string ("item" | "status" | "app" | "space" | "conversation")
required
Type of Podio object to reference.
object
Task reminder.
array
Label IDs to apply.
object
Task recurrence.
string
Task description.
string
External-system task ID.
string
Contact or contacts responsible for the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CREATE_SPACECreate a new Podio space in an organization.

Input Parameters

string
required
Name of the new space.
integer
required
ID of the organization that will contain the space.
string ("open" | "closed")
Privacy level of the space. Defaults to closed.
boolean
Whether new employees should be joined automatically.
boolean
Whether new apps should be announced with a status update.
boolean
Whether new members should be announced with a status update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CREATE_TASKCreate a personal or referenced Podio task with assignment, due date, labels, files, reminder, and recurrence.

Input Parameters

boolean
Whether Podio hooks should run for this change.
string
required
Task title text.
string
Due date and time in UTC, formatted YYYY-MM-DD HH:MM:SS.
array
Labels to apply in text form.
integer
ID of the Podio object to which the task is attached.
boolean
If true, do not bump the task in the stream or generate notifications.
boolean
Whether the task is private.
string
Due date in the connected user’s local time, formatted YYYY-MM-DD.
string
Due time in the connected user’s local time.
array
File IDs to attach to the task.
string
Podio object type to which the task is attached.
object
Reminder configuration for the task.
array
Label IDs to apply to the task.
object
Recurrence configuration for the task.
string
Task description.
string
External-system identifier for the task.
string
Responsible contact or contacts, as a user ID, a typed contact identifier, or a list containing either form.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_CREATE_TASK_LABELCreate a personal Podio task label with a name and hex color.

Input Parameters

string
required
Name of the task label.
string
required
Six-character hexadecimal label color without a leading hash.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DEACTIVATE_APPDeactivate a Podio app, removing it from the app navigator and preventing new item creation.

Input Parameters

integer
required
ID of the app to deactivate.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_APPPermanently delete a Podio app and all of its items, widgets, filters, and shares. This cannot be reversed.

Input Parameters

integer
required
ID of the app to delete.
boolean
Whether to avoid stream bumps and notifications. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_APP_FIELDRemove a field from new and updated app items. Existing items retain the field unless delete_values is true.

Input Parameters

integer
required
ID of the app containing the field.
integer
required
ID of the field to delete.
boolean
Whether to delete stored values for the field. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_COMMENTDelete one Podio comment by ID; use only for a comment the caller intends to remove.

Input Parameters

boolean
Whether Podio hooks should run for this deletion. Defaults to true.
integer
required
Podio comment ID to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_ITEMDelete one Podio item by ID; use only for an item the caller intends to remove.

Input Parameters

boolean
Whether Podio hooks should run for this change. Defaults to true.
boolean
Whether to avoid bumping the item in the stream and generating notifications. Defaults to false.
integer
required
Podio item ID to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_ITEM_REFERENCERemove the reference currently attached to a Podio item, if any.

Input Parameters

integer
required
Podio item ID whose reference should be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_ORGANIZATION_APP_STORE_PROFILEPermanently delete an organization’s app-store profile. This destructive administrative action removes the profile rather than clearing individual fields.

Input Parameters

integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_ORGANIZATION_MEMBER_ROLERemove a user’s organization-level role. This destructive administrative action changes the user’s authorization in the organization.

Input Parameters

integer
required
Podio organization ID.
integer
required
Podio user ID of the organization member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_SPACEPermanently delete a Podio space, ending all of its memberships and cancelling all outstanding space invitations.

Input Parameters

integer
required
ID of the space to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_TASKDelete one Podio task by ID; use only for a task the caller intends to remove.

Input Parameters

boolean
Whether Podio hooks should run for this change. Defaults to true.
boolean
Whether to avoid bumping the task in the stream and generating notifications. Defaults to false.
integer
required
Podio task ID to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_TASK_LABELDelete one personal Podio task label.

Input Parameters

integer
required
Podio task label ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_DELETE_USER_PROPERTYDelete one auth-client-specific property from the active Podio user.

Input Parameters

string
required
Auth-client-specific user property name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_END_ORGANIZATION_MEMBERSHIPPermanently end a user’s membership in every space in an organization. This destructive administrative action promotes other users where the target is the last admin and deletes workspaces where the target is the only member.

Input Parameters

integer
required
Podio organization ID.
integer
required
Podio user ID of the organization member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_EXPORT_ITEMSCreate a Podio batch that exports app items in XLS or XLSX format.

Input Parameters

integer
Maximum number of items to export.
integer
required
Podio app ID to export.
integer
Offset into matching items.
object
Item filters to apply.
string
Sort order when no predefined filter is used.
integer
Saved view ID; zero means the last-used view.
string ("xls" | "xlsx")
required
Spreadsheet export format.
boolean
Whether to sort descending.
boolean
Whether to split email values by type.
boolean
Whether to split phone values by type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_FILTER_ITEMS_BY_VIEWRetrieve items from a Podio app using a saved view and optional paging or sorting overrides. Setting remember persists the view selection.

Input Parameters

integer
Maximum number of items to return.
integer
required
Podio app ID containing the view.
integer
Offset into matching items.
string
Override for the view’s sort order.
integer
required
Saved view ID to apply.
boolean
Whether to remember this view for the user.
boolean
Override for descending sort order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_FIND_REFERENCEABLE_ITEMSSearch the apps allowed by a Podio reference field for items matching text.

Input Parameters

string
Case-insensitive wildcard search text.
integer
Maximum number of results.
integer
required
App reference field ID.
array
Item IDs to exclude from results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ADMIN_ORGS_BY_EMAILLook up organizations administered by an email address and free organizations containing it. This administrative lookup exposes organization membership and domain information.

Input Parameters

string
required
Email address whose administrative and free organizations should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ALL_APPSSearch apps available to the connected user.

Input Parameters

string
Text to match against app, item, or workspace names.
integer
Maximum number of apps to return. Defaults to 4.
string ("score" | "name")
Order apps by relevance score or name.
string
Right the user must have on returned apps.
boolean
Whether to exclude apps from the demo workspace.
string
Comma-separated app IDs to exclude.
integer
Preferred space ID for returned apps.
integer
Return apps referenceable in this organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ALL_SPACES_ON_ORGANIZATIONAs an organization administrator, list every workspace in the organization. Names and URLs are omitted for workspaces the administrator has not joined.

Input Parameters

integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_APPReturn a Podio app’s metadata and field definitions so an agent can construct valid item values.

Input Parameters

integer
required
Podio app ID returned by List Apps.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_APP_BY_LABELSGet a Podio app using its organization, space, and app URL labels.

Input Parameters

string
required
App URL label.
string
required
Organization URL label.
string
required
Space URL label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_APP_DEPENDENCIESGet the apps an app depends on and the dependency graph.

Input Parameters

integer
required
ID of the app to inspect.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_APP_FIELDGet one Podio app field by numeric ID or external ID.

Input Parameters

integer
required
ID of the app containing the field.
string
required
Numeric field ID or stable external field ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_APP_INVERSE_DEPENDENCIESGet apps and fields that depend on a Podio app.

Input Parameters

integer
required
ID of the referenced app.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_APP_ON_SPACE_BY_URL_LABELGet a Podio app in a space by its URL label.

Input Parameters

integer
required
ID of the app’s space.
string
required
URL label of the app.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_AVAILABLE_SEATSReturn the available employee and external seats in a Podio space.

Input Parameters

integer
required
ID of the space whose seats to inspect.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_AVAILABLE_SPACESList open Podio spaces in an organization that the connected user can join.

Input Parameters

integer
required
ID of the organization to inspect.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_COMMENTReturn one Podio comment by ID, including files, embeds, likes, and questions.

Input Parameters

integer
required
Podio comment ID returned by List Comments or Create Comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_COMMENT_REVISIONSReturn all revisions of a Podio comment, including the current revision, ordered oldest first.

Input Parameters

integer
required
Podio comment ID whose revision history to return.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_CURRENT_USERReturn the connected Podio user’s identity, profile, locale, timezone, and account status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_FEATURESGet features available from selected Podio apps.

Input Parameters

string
Comma-separated app IDs from which to extract features.
boolean
Whether to include features from the containing space.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_FIELD_RANGESReturn the minimum and maximum values for a number, calculation, or money field.

Input Parameters

integer
required
Number, calculation, or money field ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ICON_SUGGESTIONSSearch Podio app icon suggestions.

Input Parameters

string
Search term to match against app icons.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEMReturn one Podio item with its app, field values, revisions, comments, files, tags, references, and rights. By default, this also marks new item notifications as viewed; set mark_as_viewed to false to avoid that side effect.

Input Parameters

integer
required
Podio item ID returned by List Items or Create Item.
boolean
Whether to mark new notifications on this item as viewed. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_BY_APP_ITEM_IDReturn a full Podio item using its app ID and app-local item ID.

Input Parameters

integer
required
Podio app ID.
integer
required
Item’s app-local sequential ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_BY_EXTERNAL_IDReturn a Podio app item using its external-system identifier.

Input Parameters

integer
required
Podio app ID.
string
required
External-system identifier stored on the item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_CLONEReturn unsaved clone-ready values for a Podio item; this does not create an item.

Input Parameters

integer
required
Podio item ID whose clone-ready values should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_COUNTCount items in a Podio app matching a saved view or documented scalar filters.

Input Parameters

integer
required
Podio app ID whose items should be counted.
object
Documented filter keys mapped to scalar or semicolon/range-encoded values.
integer
Saved view ID; zero applies the last-used view.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_FIELD_VALUESReturn values for one numeric field ID on a Podio item.

Input Parameters

integer
required
Podio item ID.
integer
required
App field ID whose values should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_FIELD_VALUES_V2Return values for a Podio item field selected by numeric ID or external ID.

Input Parameters

integer
required
Podio item ID.
string
required
Numeric field ID or field external ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_PREVIEW_FOR_FIELD_REFERENCEReturn an item preview formatted for use by a specific Podio reference field.

Input Parameters

integer
required
Podio item ID to preview.
integer
required
Reference field ID that governs the preview.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_REFERENCESReturn up to the requested limit of items that reference a Podio item, grouped by app and field.

Input Parameters

integer
Maximum number of referencing items to return.
integer
required
Podio item ID whose incoming references should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_REVISIONReturn metadata for a specific revision of a Podio item.

Input Parameters

integer
required
Podio item ID.
integer
required
Revision number to return.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_REVISION_DIFFERENCEReturn field-value differences between two revisions of a Podio item.

Input Parameters

integer
required
Podio item ID.
integer
required
Later revision number.
integer
required
Earlier revision number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_REVISIONSReturn up to the latest 30 revisions of a Podio item.

Input Parameters

integer
required
Podio item ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEMS_AS_XLSXDownload up to 1000 filtered Podio app items as an XLSX file.

Input Parameters

integer
Number of items to export, up to 1000.
integer
required
Podio app ID to export.
integer
Offset into matching items.
object
Documented filter keys mapped to scalar or semicolon/range-encoded values.
string
Documented item sort key.
integer
Saved view ID; zero applies the last-used view.
boolean
Whether to sort descending.
boolean
Whether to include deleted columns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_VALUESReturn all populated fields and values for a Podio item.

Input Parameters

integer
required
Podio item ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ITEM_VALUES_V2Return the field values on a Podio item using the v2 value representation.

Input Parameters

integer
required
Podio item ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_MEETING_URLGet the join URL for a Podio meeting item. For the organizer, this request may start the meeting and return an automatic-login URL.

Input Parameters

integer
required
Podio meeting item ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_NOTIFICATION_SETTINGGet whether one Podio notification type is enabled for an email or mobile client.

Input Parameters

string ("email" | "mobile")
required
Podio notification client type.
string ("digest" | "bulletin" | "reference" | "message" | "space" | "subscription" | "user" | "reminder" | "push_notification" | "push_notification_sound" | "push_notification_browser")
required
Podio notification type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_NOTIFICATION_SETTINGSGet all Podio notification-type settings for an email or mobile client.

Input Parameters

string ("email" | "mobile")
required
Podio notification client type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATIONGet a Podio organization by ID, including its account limits, domains, role, tier, and creator metadata.

Input Parameters

integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATION_ADMINSList the users who administer a Podio organization.

Input Parameters

integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATION_APP_STORE_PROFILEGet an organization’s app-store profile, including its revision and Podio contact-area fields.

Input Parameters

integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATION_BY_URLResolve a Podio organization from its full URL or the URL of a resource within it.

Input Parameters

string
required
Full URL of the organization or any resource beneath it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATION_LOGIN_REPORTRetrieve an administrative report of total and active organization users by week. The report exposes organization-wide login activity counts.

Input Parameters

integer
Number of weeks to return, counting backward from the previous week.
integer
Offset into the weeks to return.
integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATION_MEMBERGet a user’s member data, contact profile, role, tier, and space counts in a Podio organization.

Input Parameters

integer
required
Podio organization ID.
integer
required
Podio user ID of the organization member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATION_MEMBERSAs an organization administrator, list invited and active members. Invited users may expose only limited user and profile information.

Input Parameters

integer
Maximum number of members to return.
string
Search term to match against members.
integer
Zero-based result offset.
integer
required
Podio organization ID. The connected user must be an organization administrator.
string ("name" | "last_seen_on")
Member sort field.
boolean
Whether to sort descending.
string ("employee" | "external" | "admin" | "regular" | "guest" | "premium")
Member type to return.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_ORGANIZATION_TASK_SUMMARYGet task summary groups for one Podio organization.

Input Parameters

integer
Maximum number of tasks returned in each summary group.
integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_PERSONAL_TASK_SUMMARYGet summary groups for personal tasks and personal-space tasks.

Input Parameters

integer
Maximum number of tasks returned in each summary group.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_PROFILE_FIELDGet one contact-area profile field for the active Podio user.

Input Parameters

string
required
Podio contact-area key of the active user’s profile field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_RECALC_STATUS_FOR_FIELDReturn recalculation status for a calculation field on a Podio item.

Input Parameters

integer
required
Podio item ID.
integer
required
Calculation field ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_REFERENCES_TO_ITEM_BY_FIELDReturn items that reference a Podio item through one specific app field.

Input Parameters

integer
Maximum number of referencing items.
integer
Offset into referencing items.
integer
required
Podio item ID being referenced.
integer
required
Reference field ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_REFERENCE_TASK_COUNTGet the total number of open tasks on a referenced Podio object.

Input Parameters

integer
required
ID of the referenced Podio object.
string
required
Podio type of the referenced object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_REFERENCE_TASK_SUMMARYGet task summary groups for one referenced Podio object.

Input Parameters

integer
Maximum number of tasks returned in each summary group.
integer
required
ID of the referenced Podio object.
string
required
Podio type of the referenced object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_SHARED_ORGANIZATIONSList organizations and spaces that the connected user shares with another Podio user, sorted by name.

Input Parameters

integer
required
Podio user ID to compare with the connected user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_SPACEReturn a Podio space by ID, including its settings, rights, creator, and membership state.

Input Parameters

integer
required
ID of the space to return.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_SPACE_APP_DEPENDENCIESGet apps on a Podio space and their dependency graph.

Input Parameters

integer
required
ID of the space to inspect.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_SPACE_BY_ORG_AND_URL_LABELReturn a Podio space using its organization ID and URL label.

Input Parameters

integer
required
ID of the organization containing the space.
string
required
URL label of the space.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_SPACE_BY_URLResolve a Podio space and its organization from a full URL or organization and space slugs.

Input Parameters

string
Full Podio resource or space URL to resolve.
string
Organization slug to search within.
string
Space URL slug to search for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_SPACE_MEMBERSHIPS_FOR_ORG_MEMBERAs an organization administrator, list a member’s workspace memberships. Sensitive workspace names and URLs are hidden when the requesting administrator is not a workspace member.

Input Parameters

integer
required
Podio organization ID.
integer
required
Podio user ID of the organization member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_SPACE_TASK_SUMMARYGet task summary groups for one Podio space.

Input Parameters

integer
Maximum number of tasks returned in each summary group.
integer
required
Podio space ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TASKReturn one Podio task with assignment, due dates, reference, labels, files, recurrence, and comments.

Input Parameters

integer
required
Podio task ID returned by List Tasks or Create Task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TASK_SUMMARYGet the connected user’s overdue, today, and other task groups.

Input Parameters

integer
Maximum number of tasks returned in each summary group.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TASK_TOTAL_BY_TIMEGet the number of tasks in a documented Podio time bucket.

Input Parameters

string ("overdue" | "due" | "today" | "all")
required
Time bucket whose task count to return.
integer
Optional Podio space ID used to limit the count.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TASK_TOTALSGet active-task totals for owned and reassigned Podio tasks.

Input Parameters

string
Optional semicolon-separated Podio space IDs used to limit totals.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TOP_APPSGet the connected user’s top Podio apps.

Input Parameters

integer
Maximum number of apps to return. Defaults to 4.
boolean
Whether to exclude apps from the demo workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TOP_APPS_FOR_ORGANIZATIONGet top Podio apps in an organization.

Input Parameters

integer
required
ID of the organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TOP_SPACESReturn the top Podio spaces for the connected user.

Input Parameters

integer
Maximum number of spaces to return. Defaults to 6.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_TOP_VALUES_FOR_FIELDReturn the top possible item values for a Podio field of type app.

Input Parameters

integer
Maximum number of results.
integer
required
App-type field ID.
array
Item IDs to exclude from results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_USERGet the active Podio user’s account details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_GET_USER_PROPERTYGet an auth-client-specific JSON object property for the active Podio user.

Input Parameters

string
required
Auth-client-specific user property name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_INCOMPLETE_TASKMark a completed Podio task incomplete using Podio’s task route.

Input Parameters

boolean
Whether Podio hooks should run for this change.
boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio task ID to change.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_INSTALL_APPInstall a Podio app on a space with selected features.

Input Parameters

integer
required
ID of the app to install.
array
Features to install: filters, widgets, integration, forms, items, flows, or votings. Omit to install all except items.
integer
required
ID of the space where the app is installed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_APPSList active Podio apps in a space, optionally including inactive apps.

Input Parameters

integer
required
Space ID returned by List Spaces.
boolean
Whether to include inactive apps. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_COMMENTSPage through comments on a Podio object such as an item or task.

Input Parameters

integer
Maximum number of comments to return in this page. Defaults to 100.
integer
Zero-based offset of the first comment to return. Pass next_offset from the previous response to continue.
integer
required
ID of the Podio object whose comments to list.
string
required
Podio reference type of the object whose comments to list, such as item or task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_ITEMSFilter and page through items in one Podio app, returning item IDs, titles, fields, and match totals. Setting remember to true also persists the filter view in Podio.

Input Parameters

integer
Maximum number of items to return in this page. Defaults to 30.
integer
required
Podio app ID whose items to return.
integer
Zero-based index of the first item to return. Pass next_offset from the previous response to continue with the same filters and sorting.
object
Map of Podio field or filter keys to their documented filter values.
string
Field or documented sort key used to order the items.
boolean
Whether Podio should remember this filter view.
boolean
Whether to sort the items in descending order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_ORGANIZATIONSList organizations available to the connected user, including member spaces and access rights.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_ORGANIZATION_WORKSPACESList Podio spaces in an organization that are accessible to the connected user.

Input Parameters

integer
required
ID of the organization to inspect.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_SPACESList the spaces the connected user can access in a Podio organization.

Input Parameters

integer
required
Organization ID returned by List Organizations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_TASK_LABELSList the connected user’s personal Podio task labels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_LIST_TASKSFilter and page through Podio tasks visible to the connected user, including open or completed tasks and reference filters.

Input Parameters

array
Application IDs used to filter tasks.
array
Organization IDs used to filter related tasks.
string
Set to full to request the full task representation.
boolean
True to require files on the task, false to require no files, or omit for no file restriction.
integer
ID of a label that returned tasks must have.
integer
Maximum number of tasks to return in this page.
array
Space IDs used to filter related tasks.
integer
Zero-based offset of the first task to return. Pass next_offset from the previous response to continue with the same filters.
string ("created_on" | "completed_on" | "rank")
Field used to sort tasks. Defaults to rank.
string
Due-date range in YYYY-MM-DD-YYYY-MM-DD format.
string ("due_date" | "created_by" | "responsible" | "app" | "space" | "org")
Grouping to apply to the returned tasks.
boolean
True to return only completed tasks; false to return only open tasks.
string
References in “type:id” form separated by semicolons.
boolean
Whether to sort tasks in descending order. Defaults to false.
string
Entities that created the task, using Podio’s auth-object filter syntax.
string
Creation date range in YYYY-MM-DD-YYYY-MM-DD format.
boolean
True to return tasks the active user assigned to someone else; false to return tasks the active user did not assign to someone else.
integer
ID of the API client through which the task was created.
string
External ID of the task.
array
User IDs responsible for the returned tasks.
string
Entities that completed the task, using Podio’s auth-object filter syntax.
string
Completion date range in YYYY-MM-DD-YYYY-MM-DD format, for example 2017-06-01-2017-06-30.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_RANK_TASKPlace a Podio task before or after other tasks in the task ranking.

Input Parameters

integer
Task ID that this task should be placed after.
integer
Task ID that this task should be placed before.
integer
required
Podio task ID to rank.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_REARRANGE_ITEMApply documented from/to field-value changes and optional priority placement to a Podio item.

Input Parameters

object
Optional field IDs mapped to from/to value changes.
integer
required
Podio item ID to rearrange.
object
Optional above/below item IDs defining priority order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_REMOVE_TASK_REFERENCERemove the object reference from a Podio task.

Input Parameters

integer
required
Podio task ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_REPLACE_TASK_LABELSReplace all labels on a Podio task using label IDs or label names.

Input Parameters

array
required
Complete replacement list of task label IDs or label names.
integer
required
Podio task ID to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_RESTORE_SPACERestore an archived Podio space, making it visible in navigation again.

Input Parameters

integer
required
ID of the archived space to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_REVERT_ITEM_REVISIONDestructively undo the change made in one revision. This restores the prior values and overwrites any later changes made to the same fields.

Input Parameters

integer
required
Podio item ID to modify.
integer
required
Revision whose individual change should be undone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_REVERT_TO_REVISIONDestructively restore an item to all values in the selected revision, undoing every change made after that revision.

Input Parameters

integer
required
Podio item ID to restore.
integer
required
Zero-based revision whose complete values should be restored.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_SET_PARTICIPATIONSet the connected user’s participation status on a Podio item.

Input Parameters

string ("invited" | "accepted" | "declined" | "tentative")
required
New participation status for the connected user.
integer
required
Podio item ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_SET_USER_PROPERTIESSet one or more auth-client-specific JSON object properties for the active Podio user.

Input Parameters

object
required
Property names mapped to their JSON object values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_SET_USER_PROPERTYSet one auth-client-specific JSON object property for the active Podio user.

Input Parameters

string
required
Auth-client-specific user property name.
object
required
New JSON object value for the property.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_AN_APP_FIELDUpdate the configuration of one Podio app field.

Input Parameters

integer
New order of the field in the app.
string
New label displayed for the field.
integer
required
ID of the app containing the field.
string ("meeting_time" | "meeting_participants" | "meeting_agenda" | "meeting_location")
Meeting field mapping.
integer
required
ID of the field to update.
boolean
Whether the field is required on items.
object
New settings specific to the field type.
string
New help text for the field.
boolean
Whether the field is hidden in create, view, and edit mode.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_APP_DESCRIPTIONUpdate a Podio app’s description.

Input Parameters

integer
required
ID of the app to update.
boolean
Whether to avoid stream bumps and notifications. Defaults to false.
string
required
Updated app description.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_APP_EXPANDEDUpdate a Podio app’s configuration, fields, and field deletions.

Input Parameters

integer
required
ID of the app to update.
object
New app configuration, if changing it.
array
New fields and configuration updates for existing fields.
boolean
Whether to avoid stream bumps and notifications. Defaults to false.
array
Fields to delete as part of this update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_APP_ORDERSet the order of apps in a Podio space.

Input Parameters

array
required
App IDs in their new order.
integer
required
ID of the space containing the apps.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_APP_USAGE_INSTRUCTIONSUpdate a Podio app’s usage instructions.

Input Parameters

string
required
Updated usage instructions for the app.
integer
required
ID of the app to update.
boolean
Whether to avoid stream bumps and notifications. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_APP_V2Update a Podio app’s configuration and fields and return the app object.

Input Parameters

integer
required
ID of the app to update.
object
New app configuration, if changing it.
array
New fields and configuration updates for existing fields.
boolean
Whether to avoid stream bumps and notifications. Defaults to false.
array
Fields to delete as part of this update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_COMMENTReplace a Podio comment’s text, external ID, files, or embedded link. Omitting embed_id removes an existing embed, so resend its ID to preserve it.

Input Parameters

string
required
Replacement comment text.
integer
Podio embed ID to attach. Omitting this field removes any existing embed; callers that need to preserve an embed must resend its ID.
array
Replacement temporary uploaded file IDs to attach to the comment.
string
Replacement URL to attach to the comment.
integer
required
Podio comment ID returned by List Comments or Create Comment.
string
Replacement external-system identifier for the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_ITEMUpdate one Podio item’s fields or metadata, optionally using its revision for optimistic concurrency.

Input Parameters

object
Replacement reference from the item to another Podio object.
boolean
Whether Podio hooks should run for this change. Defaults to true.
array
Complete list of tags for the item.
object
Map of app field ID or external ID to the value shape required by that Podio field type. Use an empty array to delete all values for a field.
boolean
Whether to avoid bumping the item in the stream and generating notifications. Defaults to false.
integer
required
Podio item ID to update.
array
Complete list of file attachment IDs for the item.
object
Replacement reminder configuration for the item.
integer
Current item revision used for optimistic concurrency control.
object
Replacement recurrence configuration for the item.
string
Replacement external-system identifier for the item.
integer
Linked account ID to use for a meeting item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_ITEM_FIELD_VALUESReplace the values of one Podio item field selected by numeric ID or external ID.

Input Parameters

boolean
Whether Podio hooks should run.
boolean
Whether to suppress stream bumps and notifications.
string
required
Complete replacement value in the shape required by the field type; arrays are sent as arrays, not wrapped.
integer
required
Podio item ID to update.
string
required
Numeric field ID or field external ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_ITEM_VALUESReplace values for multiple fields on a Podio item using field IDs or external IDs.

Input Parameters

boolean
Whether Podio hooks should run.
object
required
Field IDs or external IDs mapped to complete replacement values.
boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio item ID to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_NOTIFICATION_SETTINGEnable or disable one Podio notification type for an email or mobile client.

Input Parameters

boolean
required
Whether this notification type should be enabled.
string ("email" | "mobile")
required
Podio notification client type.
string ("digest" | "bulletin" | "reference" | "message" | "space" | "subscription" | "user" | "reminder" | "push_notification" | "push_notification_sound" | "push_notification_browser")
required
Podio notification type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_NOTIFICATION_SETTINGSUpdate multiple Podio notification-type settings for an email or mobile client.

Input Parameters

object
required
Notification types mapped to whether each type should be enabled.
string ("email" | "mobile")
required
Podio notification client type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_ORGANIZATIONAdministratively update a Podio organization’s name, URL subdomain, or logo. Changing the name alone does not change its URL.

Input Parameters

integer
New organization logo file ID.
string
New organization name. Changing it does not change the organization URL.
integer
required
Podio organization ID to update.
string
New URL subdomain; defaults to the existing URL label when omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_ORGANIZATION_APP_STORE_PROFILEAdministratively replace fields on an existing Podio organization app-store profile.

Input Parameters

object
required
App-store profile fields using Podio contact-area field names and values. These are sent as the top-level request body.
integer
required
Podio organization ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_PROFILEUpdate selected contact-area fields on the active Podio user’s profile; omitted fields remain unchanged.

Input Parameters

object
required
Profile field names mapped to replacement values or lists of values. Use null to delete a field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_PROFILE_FIELDUpdate one contact-area field on the active Podio user’s profile.

Input Parameters

string
required
Podio contact-area key of the active user’s profile field.
string
required
Replacement value for the profile field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_SPACEUpdate a Podio space’s name, privacy, automatic joining, URL label, or announcement settings.

Input Parameters

string
New name of the space.
string ("open" | "closed")
New privacy level of the space.
integer
required
ID of the space to update.
boolean
Whether new employees should be joined automatically.
string
New URL label of the space.
boolean
Whether new apps should be announced with a status update.
boolean
Whether new members should be announced with a status update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_TASKUpdate a Podio task’s full attributes, including completing or reopening it. COMPLETE_TASK and INCOMPLETE_TASK remain convenient dedicated state actions.

Input Parameters

boolean
Whether Podio hooks should run for this change.
string
Replacement task title.
array
Replacement labels as label IDs or label texts.
integer
Replacement reference ID; provide together with ref_type.
boolean
Whether to avoid bumping the task in the stream and generating notifications.
boolean
Whether the task is private.
integer
required
Podio task ID to update.
string
Replacement due date in the user’s timezone, formatted YYYY-MM-DD.
string
Replacement due time in the user’s timezone.
array
Replacement list of attached file IDs.
string
Replacement reference type; provide together with ref_id.
object
Replacement reminder. Set remind_delta to null to remove it.
boolean
Whether the task is completed; false reopens a completed task.
string
Replacement task description.
integer
User ID newly responsible for the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_TASK_DESCRIPTIONReplace only the description of a Podio task.

Input Parameters

boolean
Whether Podio hooks should run for this change.
boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio task ID to update.
string
required
New task description.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_TASK_DUEUpdate only the UTC or local due fields of a Podio task.

Input Parameters

boolean
Whether Podio hooks should run for this change.
string
New UTC due date and time.
boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio task ID to update.
string
New local due date.
string
New local due time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_TASK_LABELReplace the name and color of a personal Podio task label.

Input Parameters

string
required
New name of the task label.
string
required
New six-character hexadecimal color without a leading hash.
integer
required
Podio task label ID to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_TASK_PRIVATEUpdate only whether a Podio task is private.

Input Parameters

boolean
Whether Podio hooks should run for this change.
boolean
Whether to suppress stream bumps and notifications.
boolean
required
Whether the task should be private.
integer
required
Podio task ID to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_TASK_REFERENCEReplace the object reference on a Podio task.

Input Parameters

boolean
Whether Podio hooks should run for this change.
integer
required
ID of the new referenced Podio object.
boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio task ID to update.
string
required
New Podio reference type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PODIO_UPDATE_TASK_TEXTReplace only the text of a Podio task.

Input Parameters

boolean
Whether Podio hooks should run for this change.
string
required
New task text.
boolean
Whether to suppress stream bumps and notifications.
integer
required
Podio task ID to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not