Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.onlyfanskit.dev/llms.txt

Use this file to discover all available pages before exploring further.

For an in-product connect experience, create a client session and render the hosted page in a popup or iframe. The creator never enters credentials in your UI, and you never handle a cookie.

​
Create the session

curl -X POST https://api.onlyfanskit.dev/v1/connect/client-sessions \
  -H "Authorization: Bearer $OFK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Connect your OnlyFans account",
    "client_reference_id": "user_42"
  }'
You get a client_session_id, an embed_url, and a phone_url: 
{
  "client_session_id": "att_...",
  "client_reference_id": "user_42",
  "state": "awaiting_mobile_session",
  "embed_url": "https://api.onlyfanskit.dev/v1/connect/login/att_.../embed?token=...",
  "phone_url":  "https://api.onlyfanskit.dev/v1/connect/login/att_.../phone?token=..."
}

​
Open the popup

The onlyfanskit/browser helper opens embed_url in a managed popup and resolves when the creator finishes: 
import { startOnlyFansAuth } from "onlyfanskit/browser";

const result = await startOnlyFansAuth({ embedUrl });
// result.accountId once connected
You can also just link the creator to phone_url — it renders a standalone page they can open on any device.

​
Track completion

Poll the session the same way as any attempt (GET /v1/connect/login/{client_session_id}), or attach a webhook to be notified when the account connects. The client_reference_id you passed is echoed back so you can correlate the session with your own user.