Pipedrive Laravel

Talk to the Pipedrive API from Laravel: config-driven app credentials and Laravel's own HTTP client under the hood.

In this example, we build a client from a token stored for a user and read the authorized user:

use Pipedrive\Client\PipedriveClient;
use Pipedrive\Laravel\Http\LaravelHttpClient;

$pipedrive = PipedriveClient::factory()
    ->withClientCredentials(config('pipedrive.auth.client_id'), config('pipedrive.auth.client_secret'))
    ->withToken($accessToken, $expiresAt, $refreshToken, $apiDomain)
    ->withHttpClient(new LaravelHttpClient)
    ->make();

$user = $pipedrive->users()->me();

Not using Laravel? See karim-tao/pipedrive-client.

Installation

Requires PHP 8.3+ and Laravel 12 or 13.

You can install the package via composer:

composer require karim-tao/pipedrive-laravel

The service provider is discovered automatically. Publish the config file if you want to change it:

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

Configuration

Set the credentials of your Pipedrive app in .env:

PIPEDRIVE_CLIENT_ID=your-client-id
PIPEDRIVE_CLIENT_SECRET=your-client-secret

All options

Everything in config/pipedrive.php:

How it works

Pipedrive tokens belong to each user who connects their company, so there is no shared client: build one per user with PipedriveClient::factory() and pass LaravelHttpClient, a PSR-18 adapter over Laravel's Http facade, so it honours your HTTP config, fakes and middleware.

Pipedrive gives a new refresh token on every refresh. Pass an event dispatcher with withEventDispatcher() to store the new pair as soon as the client dispatches Pipedrive\Client\Events\TokenRefreshed.

Testing

composer test

Because requests go through Laravel's Http facade, Http::fake() works out of the box:

Http::fake([
    '*/api/v1/users/me' => Http::response(['success' => true, 'data' => ['id' => 5, 'name' => 'Karim']]),
]);

License

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