Connect with email + password

Start a login with the creator’s email and password. The call returns immediately with an attempt_id; the login runs in the background and you poll until it resolves.

Start the attempt

curl -X POST https://api.onlyfanskit.dev/v1/connect/login \
  -H "Authorization: Bearer $OFK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "creator@example.com",
    "password": "<password>",
    "remember_credentials": true
  }'

Returns 202 with an attempt:

{
  "attempt_id": "att_...",
  "state": "pending",
  "polling_url": "/v1/connect/login/att_..."
}

Set remember_credentials: true to seal the credentials so the account can later be reauthenticated without a fresh login.

Poll until it resolves

curl https://api.onlyfanskit.dev/v1/connect/login/$ATTEMPT_ID \
  -H "Authorization: Bearer $OFK_KEY"

Keep polling while state is pending. It ends at completed_success (with an account_id) or parks on a 2FA state.

Resolve any challenge

If state becomes needs_otp, needs_app_otp, needs_email, or needs_face_otp, submit the code or signal completion. See Two-factor & challenges.

Fields

Field	Required	Notes
`email`, `password`	for credentials login	The creator’s OnlyFans login.
`auth_type`	no	`credentials` (default) or `mobile_app`.
`remember_credentials`	no	Store credentials so the account can be reauthenticated later without a fresh login.
`label`	no	Human label.
`proxy_country`	no	Region for the account’s traffic — `us` or `uk`.

Email/password login may be temporarily unavailable, returning 503. When it is, use mobile / QR or embedded connect instead — those have no such dependency.

Overview

Guides

Connect with email + password

Fields

​Fields

Fields