Creates or updates an item within your Podio app

Use this action to create or update an item within your Podio app (see https://help.podio.com/hc/en-us/articles/201019278-Creating-apps-).
Pass in dictionary with field keys and their values.
Field key is located under Modify app -> Advanced -> Developer -> External ID (see https://developers.podio.com/examples/items).

Supported platforms ios, android, mac
Author @pprochazka72, @laugejepsen

1 Example

  identifying_value: "Your unique value",
  other_fields: {
    "field1" => "fieldValue",
    "field2" => "fieldValue2"


Key Description Default
client_id Client ID for Podio API (see https://developers.podio.com/api-key)
client_secret Client secret for Podio API (see https://developers.podio.com/api-key)
app_id App ID of the app you intend to authenticate with (see https://developers.podio.com/authentication/app_auth)
app_token App token of the app you intend to authenticate with (see https://developers.podio.com/authentication/app_auth)
identifying_field String specifying the field key used for identification of an item
identifying_value String uniquely specifying an item within the app
other_fields Dictionary of your app fields. Podio supports several field types, see https://developers.podio.com/doc/items

* = default value is dependent on the user's system

Lane Variables

Actions can communicate with each other using a shared hash lane_context, that can be accessed in other actions, plugins or your lanes: lane_context[SharedValues:XYZ]. The podio_item action generates the following Lane Variables:

SharedValue Description
SharedValues::PODIO_ITEM_URL URL to newly created (or updated) Podio item

To get more information check the Lanes documentation.


To show the documentation in your terminal, run

fastlane action podio_item


It is recommended to add the above action into your Fastfile, however sometimes you might want to run one-offs. To do so, you can run the following command from your terminal

fastlane run podio_item

To pass parameters, make use of the : symbol, for example

fastlane run podio_item parameter1:"value1" parameter2:"value2"

It's important to note that the CLI supports primitive types like integers, floats, booleans, and strings. Arrays can be passed as a comma delimited string (e.g. param:"1,2,3"). Hashes are not currently supported.

It is recommended to add all fastlane actions you use to your Fastfile.

Source code

This action, just like the rest of fastlane, is fully open source, view the source code on GitHub

Back to actions