Skip to main content

Klips: Creating Podio data sources

Updated

You can set up a connection between Klipfolio Klips and Podio to display your work management data on a dashboard.

Overview

Available in the Service Connectors page 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 your list of data sources, click Create a New Data Source and select Podio from the Service Connectors page.

  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. Click Continue.
  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 data.
  2. Ensure this is the data you’re looking for. Optionally, select the checkbox to Model your data. Learn more about modelling data sources.
  3. Click Continue.
  4. Name, choose refresh settings, and, optionally, share your data source.
  5. Click Save.

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 articles

Related articles