Back to the top level: Podero Partner API Developer Reference

Making your first API calls

This tutorial walks you through some of the main functionalities of our Partner API.

Table of contents

Prerequisites

Before we get started make sure you have completed the following steps:

  1. Contact Podero Sales: [email protected] to request credentials.
  2. We will set up an Organisation and an Admin User.
  3. You will receive an Organisation ID (org_id) and an initial username and password.
  4. If you have also requested Sandbox access, you will receive a unique sandbox code.

This guide uses curl for examples, but you can use Postman or any other API testing suite.

Step 1: Register a new Application

Log in at https://app.podero.com/accounts/login/ with the credentials you received. It is strongly recommended that you change the password.

Visit https://app.podero.com/oauth2/applications/register/ (or use your sandbox URL subdomain), to create a new client application. Immediately copy the client id and the client secret and keep them somewhere safe. You will not be able to retrieve your client secret later.

Give your application a name and select “Client type” = “Confidential” and “Authorization grant type” = “Client Credentials”. Redirect URIs are not necessary. Save the application.

Untitled

Step 2: Get your token

To get an access token and to be able to use the API, you need to make a request to https://app.podero.com/oauth2/token/ with a Basic Auth header using your base64 encoded client id and secret (remember to replace the subdomain if you’re in a sandbox environment):