ONonlyfansapi
Connect OnlyFans Account

Start Authentication

Changed on

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

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/authenticate
  • Auth
    HTTP bearer

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' | 'gb'

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": "natus",
  "email": "green.rau@example.net",
  "password": "dR&$)4`J|@",
  "auth_id": "hic",
  "cookies": "quia",
  "xbc": "non",
  "user_agent": "nihil",
  "proxyCountry": "us",
  "customProxy": {
    "host": "proxy.example.com",
    "port": 8080,
    "username": "tempora",
    "password": "M.;c1O_fWvPE]W"
  }
}

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

Changes

  • b3968f1bc1f0Revision changes
    • info

      added the new gb enum value to the request property

  • 93a6dfdeeb67Revision changes
    • breaking

      removed the enum value cz of the request property

    • breaking

      removed the enum value de of the request property

    • breaking

      removed the enum value es of the request property

    • breaking

      removed the enum value fr of the request property

    • breaking

      removed the enum value hu of the request property

    • breaking

      removed the enum value it of the request property

    • breaking

      removed the enum value pl of the request property

    • breaking

      removed the enum value ro of the request property

    • breaking

      removed the enum value sk of the request property

    • breaking

      removed the enum value ua of the request property

    • breaking

      added subschema #1 subschema #2 to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      request body became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional