Podio for Laravel

Talk to the Podio API from Laravel through a clean, testable Podio facade — config-driven auth, cached tokens, and Laravel's own HTTP client under the hood.

In this example, we create an item and comment on it — authentication is handled for you:

use Podio\Laravel\Facades\Podio;

$item = Podio::items()->create($appId, [
    'fields' => ['title' => 'New lead'],
]);

Podio::comments()->create('item', $item->item_id, [
    'value' => 'Created from the contact form',
]);

Installation

Requires PHP 8.3+ and Laravel 12 or 13.

You can install the package via composer:

composer require podio-labs/podio-laravel

That's it — the PodioServiceProvider and Podio facade are auto-discovered, so you're ready to go.

Optionally, publish the config file:

php artisan vendor:publish --tag=podio-config

Configuration

Minimal

Configure your .env:

PODIO_CLIENT_ID=your-app-client-id
PODIO_CLIENT_SECRET=your-app-client-secret
PODIO_USERNAME=service@example.com
PODIO_PASSWORD=password

Full

Everything in config/podio.php:

Usage

Endpoints

Everything goes through the Podio facade.

use Podio\Laravel\Facades\Podio;

// Items
$item = Podio::items()->get($itemId);
$item = Podio::items()->create($appId, ['fields' => ['title' => 'Hello']]);
$item = Podio::items()->update($itemId, ['fields' => ['title' => 'Updated']]);
$total = Podio::items()->getCount($appId);

// Files
$file = Podio::files()->upload($absolutePath, 'photo.jpg');
Podio::files()->attach($file->file_id, ['ref_type' => 'item', 'ref_id' => $itemId]);
$bytes = Podio::files()->getRaw($fileId);

// Comments & embeds
Podio::comments()->create('item', $itemId, ['value' => 'Imported from Dropbox']);
$embed = Podio::embed()->create(['url' => 'https://youtu.be/...']);

// Webhooks
$hooks = Podio::hooks()->getForApp($appId);
$hook = Podio::hooks()->createForApp($appId, ['url' => route('podio.hook'), 'type' => 'item.create']);
Podio::hooks()->verify($hook->hook_id);

// Apps
$app = Podio::apps()->get($appId);

Raw requests

For anything not covered by an endpoint, send a request directly:

$response = Podio::send('GET', '/item/123', ['raw' => true]);

$response->statusCode();
$response->body();
$response->rateLimit();

Rate limit

Podio::rateLimit()->limit();
Podio::rateLimit()->remaining();

How it works

Podio\Laravel\Podio builds a Podio\Client\PodioClient from your config and:

• transports requests through Laravel's Http facade via a PSR-18 adapter (LaravelHttpClient) — so it honours your HTTP config, fakes, and middleware;
• caches the OAuth access token (cache.store / cache.key) and reuses it across requests, so you are not re-authenticating on every call.

The facade is bound as a singleton, so the client — and its cached token — is shared for the lifetime of the request.

Testing

composer test

Because transport runs through the Http facade, you can fake Podio in your own tests:

Http::fake([
    'api.podio.com/oauth/token' => Http::response(['access_token' => 'test', 'expires_in' => 3600]),
    'api.podio.com/item/*' => Http::response(['item_id' => 1]),
]);

License

Podio Laravel is open-sourced software licensed under the MIT license.