Authentication

Secure links with powerful analytics

API Configuration

Request Headers

All Linkify API endpoints require a valid Bearer token passed in the HTTP Authorization header. Tokens are generated via the dashboard or OAuth 2.0 flow and expire after 90 days of inactivity.

Authorization

Authorization: Bearer sk_live_8f3a9c2d1e4b5f6a7c8d9e0f1a2b3c4d

Content Negotiation

Content-Type: application/json
Accept: application/vnd.linkify.v1+json

Permissions

OAuth Scopes

Fine-grained scopes control what your application can access. Request only the permissions necessary for your integration to maintain the principle of least privilege.

links:read

Retrieve short URL lists, resolve destination targets, and view creation timestamps without modifying records.

links:write

Create new redirects, update destination URLs, toggle link status, and permanently delete archived short links.

analytics:read

Access click-through rates, geographic distribution, referrer sources, and device breakdowns for reporting dashboards.

domains:manage

Configure custom branded domains, verify DNS TXT records, and provision automatic SSL certificates.