PHP SDK

composer require fopost/sdk

use Fopost\Sdk\Client;

$client = new Client('fp_...');  // or set FOPOST_API_KEY

$workspace = $client->workspaces()->list()[0];
$accounts = $client->accounts()->list($workspace->id);

$post = $client->posts()->create(
    workspaceId: $workspace->id,
    content: 'Hello from PHP',
    accounts: array_map(fn ($a) => $a->id, $accounts),
);

$client->posts()->publish($post->id);

$client = new Client(
    apiKey: 'fp_...',
    baseUrl: 'https://api.fopost.com',
    timeout: 30.0,      // seconds
    maxRetries: 3,      // attempts, on 429 only
);

use DateTimeImmutable;

$client->posts()->create(
    workspaceId: $workspaceId,
    content: ['First post in the thread', 'The reply'],
    accounts: ['acc_1', 'acc_2'],
);

$client->posts()->create(
    workspaceId: $workspaceId,
    content: 'Going out on Monday',
    accounts: ['acc_1'],
    status: 'scheduled',
    scheduleAt: new DateTimeImmutable('2026-09-02T09:00:00Z'),
);

$body = $client->request('GET', '/some/new/endpoint', params: ['workspace_id' => $workspaceId]);

use Fopost\Sdk\Exception\FopostException;
use Fopost\Sdk\Exception\RateLimitException;
use Fopost\Sdk\Exception\ValidationException;

try {
    $client->posts()->publish('p_123');
} catch (ValidationException $e) {
    print_r($e->getErrors());
} catch (RateLimitException $e) {
    echo 'retry in ', $e->getRetryAfter(), 's';
} catch (FopostException $e) {
    echo $e->getStatus(), ' ', $e->getMessage();
}

use Fopost\Sdk\Client;
use Fopost\Sdk\Http\Response;
use Fopost\Sdk\Http\Transport;

$fake = new class implements Transport {
    public function send(string $method, string $url, array $headers, ?string $body): Response
    {
        return new Response(200, [], json_encode(['data' => []]));
    }
};

$client = new Client('fp_test_key', Client::DEFAULT_BASE_URL, 30.0, 3, $fake);