Sign in

v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Connect OnlyFans Account

Start Authentication

Start the authentication process for a new account. Supports three methods: email/password (default), cookies & headers (raw_data), or FansAPI Auth+ mobile app (mobile_app). For email/password, our systems will bypass Captcha and ask you for 2FA if required. For raw_data, provide session cookies directly for instant authentication. For mobile_app, the response includes a mobile_auth_session_deeplink that the creator opens on their phone (or scans as a QR code) to complete authentication via the FansAPI Auth+ mobile app. All credentials are stored securely and encrypted at rest.

post/api/authenticate

Request body

auth_type'email_password' | 'raw_data' | 'mobile_app'

The authentication method to use. Defaults to email_password if omitted. Use mobile_app to authenticate via the FansAPI Auth+ mobile app (no credential fields required).

namestring

A display name for the account. If omitted, defaults to the email address or auth_id.

emailstring

The email address of the OnlyFans account. Required when auth_type is email_password.

passwordstring

The password of the OnlyFans account. Required when auth_type is email_password.

auth_idstring

The auth_id from OnlyFans session cookies. Required when auth_type is raw_data.

cookiesstring

The full cookie string (semicolon-separated). Required when auth_type is raw_data.

xbcstring

The X-BC token from request headers. Required when auth_type is raw_data.

user_agentstring

The browser User-Agent string. Required when auth_type is raw_data.

proxyCountry'us' | 'uk'

The country of the managed proxy server you want to use. Eg. "us" for United States. Cannot be used together with customProxy.

force_connectboolean

Set to true to connect the account even if it already exists

Example request

{
  "auth_type": "email_password",
  "name": "molestiae",
  "email": "ismael91@example.com",
  "password": "iRPp(K\"M[C1Qv,f",
  "auth_id": "accusamus",
  "cookies": "unde",
  "xbc": "suscipit",
  "user_agent": "velit",
  "proxyCountry": "us",
  "customProxy": {
    "host": "proxy.example.com",
    "port": 8080,
    "username": "et",
    "password": "}b2XD-AinlA~Cg9="
  }
}

Response

OR

Example response

{
  "attempt_id": "auth_XXXXXXXXXXXXXXXXXXXXX",
  "message": "Authentication process started. Query the polling_url to check the progress.",
  "polling_url": "https://app.onlyfansapi.com/api/authenticate/auth_XXXXXXXXXXXXXXXXXXXXX"
}