README

Official PHP SDK for the Cortova CRM API.

composer require cortova/sdk

Requires PHP 8.1+, ext-curl, ext-json. No other runtime deps.

Quickstart

<?php
use Cortova\Client;

$ctv = new Client(['apiKey' => getenv('CORTOVA_KEY')]);

// Single page
$page = $ctv->companies()->list(after: null, limit: 25);
foreach ($page['items'] as $c) echo $c['name'], "\n";
echo "next cursor: ", ($page['nextCursor'] ?? '(end)'), "\n";

// Auto-paginated iterator
foreach ($ctv->leads()->iter() as $lead) echo $lead['companyName'], "\n";

// Create a record
$new = $ctv->companies()->create(['name' => 'Acme Corp', 'industry' => 'SaaS']);
echo $new['id'];

What's covered

• $ctv->companies() — list, get, create, iter, contacts, iterContacts
• $ctv->leads() — list, get, create, iter
• $ctv->opportunities() — list($status?), get, iter($status?)
• $ctv->activities() — list, iter
• $ctv->tasks() — list($activeOnly?), get, iter($activeOnly?)
• $ctv->pipelines() — list, get, iter

iter() is a PHP generator that handles cursor pagination automatically.

Errors

use Cortova\CortovaError;
try { $ctv->companies()->get('not-real'); }
catch (CortovaError $e) {
    error_log("HTTP {$e->status}: " . json_encode($e->body));
}

License

Apache-2.0.