inbio/inbio — official PHP SDK for INBIO (in.bio)

$result = \Inbio\Inbio::shorten('https://example.com/some/very/long/url');
echo $result->shortUrl; // https://in.bio/abc123

use Inbio\Client;

$client = new Client(token: 'YOUR_API_TOKEN');

$link = $client->links->create('https://example.com/sale', slug: 'spring-sale');
echo $link->shortUrl; // https://in.bio/spring-sale

$client = new Client(); // reads INBIO_API_TOKEN

// One page at a time
$page = $client->links->list(status: 'active', perPage: 50);
foreach ($page->data as $link) {
    echo "{$link->slug}: {$link->totalClicks} clicks\n";
}
echo $page->total;       // total matching links
echo $page->currentPage; // current page number
var_dump($page->hasNext); // is there a next page?

// Or let the SDK paginate for you — iterate() is a Generator
foreach ($client->links->iterate(tag: 'marketing') as $link) {
    echo $link->shortUrl, "\n";
}

$link = $client->links->create(
    'https://example.com/sale',
    slug: 'spring-sale',          // omit for a random slug
    title: 'Spring sale',
    redirectType: 301,            // 301, 302 (default) or 307
    folderId: 3,
    tags: ['marketing', 'q3'],    // created on the fly
    expiresAt: '2026-09-01T00:00:00+00:00', // Pro+
    fallbackUrl: 'https://example.com',     // shown after expiry; Pro+
    clickLimit: 10000,            // Pro+
    password: 'hunter2',          // Pro+
    utm: ['source' => 'newsletter', 'campaign' => 'spring'],
);

$client->links->update(42, title: 'New title', tags: ['sale']);
// or with an array: $client->links->update(42, ['title' => 'New title']);

$client->links->disable(42); // active -> disabled
$client->links->enable(42);  // disabled -> active
$client->links->delete(42);  // soft-delete, stops redirecting

$result = $client->links->bulkCreate([
    ['destination_url' => 'https://example.com/1', 'slug' => 'promo-1'],
    ['destination_url' => 'https://example.com/2', 'slug' => 'promo-2'],
]);

foreach ($result->created as $link) { /* Link objects */ }
foreach ($result->failed as $row) {
    echo "row {$row['index']} failed: {$row['error']}\n";
}

file_put_contents('spring-sale.png', $client->links->qr(42, size: 512));
file_put_contents('spring-sale.svg', $client->links->qr(42, format: 'svg'));

$stats = $client->links->analytics(42, from: '2026-06-01', to: '2026-07-01');

echo $stats->totals['clicks'];   // 1240
echo $stats->totals['uniques'];  // 981
foreach ($stats->series as $day) {
    echo "{$day['date']}: {$day['clicks']}\n";
}
// Also: $stats->countries, ->devices, ->browsers, ->referrers (top 10 by clicks)

foreach ($client->folders->list() as $folder) {
    echo "{$folder->name} ({$folder->linksCount} links)\n";
}
foreach ($client->tags->list() as $tag) {
    echo "{$tag->name}\n";
}

$usage = $client->account->usage();
echo $usage->plan;                          // "pro"
echo $usage->usage['links_created'];        // 120
echo $usage->limits['links_per_month'];     // 2000

use Inbio\Exception\SignatureVerificationException;
use Inbio\Resources\Webhooks;

// In your HTTP handler (plain PHP shown; the same works in any framework):
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_INBIO_SIGNATURE'] ?? '';

try {
    $event = (new Webhooks())->verify($payload, $signature, $endpointSecret);
    // or: $client->webhooks->verify(...)
} catch (SignatureVerificationException $e) {
    http_response_code(400);
    exit;
}

match ($event->event) {
    'link.created' => handleCreated($event->data),
    'link.click_limit_reached' => notifyTeam($event->data),
    default => null,
};

http_response_code(200);

use Inbio\Exception\RateLimitException;
use Inbio\Exception\ValidationException;

try {
    $client->links->create('https://example.com', slug: 'taken');
} catch (ValidationException $e) {
    print_r($e->errors); // ['slug' => ['This slug is already taken.']]
} catch (RateLimitException $e) {
    sleep($e->retryAfter ?? 60);
}

$client = new Client(
    token: 'YOUR_API_TOKEN',
    baseUrl: 'https://in.bio', // default
    timeout: 30.0,             // seconds, default 30
    maxRetries: 2,             // default 2
);

$client = new \Inbio\Client();