> ## 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.

# Connect with email + password

> Connect an account with the creator's email and password. Start a login, poll until it resolves, and handle any SMS, authenticator, or email challenge.

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.

<Steps>
  <Step title="Start the attempt">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    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:

    ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    {
      "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](/connect/two-factor#reauthentication)
    without a fresh login.
  </Step>

  <Step title="Poll until it resolves">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    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.
  </Step>

  <Step title="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](/connect/two-factor).
  </Step>
</Steps>

## 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`.                                     |

<Note>
  Email/password login may be temporarily unavailable, returning `503`. When
  it is, use [mobile / QR](/connect/mobile) or [embedded connect](/connect/embed)
  instead — those have no such dependency.
</Note>