Creating a Podio Data Source

 

Available in the Connector Gallery

Yes, click here to view the Connector Gallery.

API Documentation Podio API Documentation

Authentication Method

OAuth Token Authentication
Response Format JSON

API Limits

By default, Podio returns 20 records per query. To return more records, append &limit=n where n <= 500 (the maximum allowed by Podio) to the query. To return data beyond the first 500 records, use the limit and offset parameters. For example, to start at the 501st record and get the next 200 records:

&offset=500?limit=200

To retrieve more than 500 records, pagination is required.

Pagination Method

Podio returns a maximum 500 records per query and each response provides a total value to indicate the total number of records. To page through the data, use the offset and limit parameters in your Podio query.

Refer to Data Sources with Multiple Pages for details on how to handle pagination.

Date Parameters

Podio uses a number of date parameters, all of which use the following formats:

yyyy-MM-dd
yyyy-MM-dd hh:mm:ss

Sample Queries

https://api.podio.com/contact
https://api/podio.com/task/12345678
https://api.podio.com/item/app/12345678?limit=500

Prerequisites

  • You must have an active Podio account.

Step-by-Step

To create a Podio data source:

  1. Go to the Data Sources Library, click Create a New Data Source and select Podio from the Connector Gallery.

  1. Click Create a custom Podio data source.
  1. Select Connect an account. You will be redirected to Podio where you will be prompted to type your Podio credentials (Email and Password) and click Login.
  1. You will be returned to Klipfolio: click Next Step.
  1. To write your Query URL, refer to Podio API Documentation and our Guide to REST API data sources as well as the following examples (orange text indicates values to be replaced with your specific values).

Organizations

https://api.podio.com/org?url=klipfolio

Contacts

https://api.podio.com/contact
https://api.podio.com/contact/123456789
https://api.podio.com/contact/123456789,987654321

Tasks

https://api.podio.com/task?completed=false&org=123456

Apps

https://api.podio.com/item/app/12345678?limit=500
https://api.podio.com/item/app/12345678?limit=500&offset=500

    • set Data Format to JSON
    • set Method to GET
  1. Click Get Resource, validate the data returned and click Continue to save your Podio data source.

Optional: Craft the query (CSV format)

If you would like to retrieve your Podio data in CSV format,

  1. At URL, enter https://api.podio.com/item/app/Your-APP-ID/csv/
  2. At Data Format, select CSV.
  3. At Method, select GET.

Related Links