Embedded connect - onlyfanskit

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=..."
}

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.