> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofauth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reconnect a linked account

> Creates a 15-minute journey for the owner to reconnect this authorization's exact account. `redirect_uri` must exactly match a registered OAuth redirect URI. Open the returned `url`; the owner returns with `state` and `reconnect=completed`, `canceled`, `expired`, or `denied`. Confirm recovery with the existing account status or `linked_account.reconnected` event. This preserves authorization and account IDs, scopes, and unrelated accounts. It never retries an interrupted request. An expired OAuth token must be refreshed before this endpoint can be called.



## OpenAPI

````yaml /openapi/v3.json post /v3/linked-accounts/{id}/reconnect
openapi: 3.1.0
info:
  title: OFAuth API
  version: 1.0.0
  description: >-
    OFAuth V3 API for linking accounts, making OnlyFans API requests, and
    receiving events.
  contact:
    email: support@ofauth.com
    url: https://ofauth.com/
servers:
  - url: https://api.ofauth.com
security:
  - ExternalOAuth: []
tags:
  - name: Link
    description: Link accounts, get and refresh tokens, and end access.
  - name: Linked accounts
    description: The linked accounts of one authorization, and their settings.
  - name: Access
    description: Make OnlyFans API requests for a linked account.
  - name: Analytics
    description: 'Access: charts, rankings, and performance data.'
  - name: Earnings
    description: 'Access: earnings charts, transactions, and chargebacks.'
  - name: Messages
    description: 'Access: messaging, chats, queue, and mass messaging.'
  - name: Posts
    description: 'Access: create, edit, list, and manage posts.'
  - name: Promotions
    description: 'Access: promotions, trials, and bundles.'
  - name: Users
    description: 'Access: user profiles, subscriptions, and actions.'
  - name: Vault
    description: 'Access: vault folders, media, and management.'
  - name: Upload
    description: 'Access: media upload and processing.'
  - name: Self
    description: 'Access: linked account profile and settings.'
  - name: Stories
    description: 'Access: stories listing and management.'
  - name: Subscriptions
    description: 'Access: subscription offers, discounts, and management.'
  - name: Realtime
    description: Webhook event formats, including OnlyFans activity events.
externalDocs:
  description: OFAuth Developer Documentation
  url: https://docs.ofauth.com
paths:
  /v3/linked-accounts/{id}/reconnect:
    post:
      tags:
        - Linked accounts
      summary: Reconnect a linked account
      description: >-
        Creates a 15-minute journey for the owner to reconnect this
        authorization's exact account. `redirect_uri` must exactly match a
        registered OAuth redirect URI. Open the returned `url`; the owner
        returns with `state` and `reconnect=completed`, `canceled`, `expired`,
        or `denied`. Confirm recovery with the existing account status or
        `linked_account.reconnected` event. This preserves authorization and
        account IDs, scopes, and unrelated accounts. It never retries an
        interrupted request. An expired OAuth token must be refreshed before
        this endpoint can be called.
      operationId: linkedAccounts.createReconnect
      parameters:
        - schema:
            type: string
            minLength: 1
            example: conn_example123
          required: true
          name: id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LinkedAccountReconnectRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountReconnectJourney'
          description: Owner reconnect journey created.
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountReconnectError400'
          description: >-
            Bad Request. `error` is `invalid_redirect_uri` (`correct_request`),
            `invalid_request`. `invalid_request`: expected only `redirect_uri`
            and nonempty `state` (at most 1024 characters).
            `invalid_redirect_uri`: return URL is not registered for this
            client.
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
        '401':
          description: >-
            Unauthorized. `error` is `authorization_required`
            (`restart_authorization`), `external_oauth_bearer_required`
            (`obtain_external_oauth_token`), `grant_revoked_or_expired`
            (`restart_authorization`), `invalid_token`
            (`obtain_external_oauth_token`).
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
            WWW-Authenticate:
              schema:
                type: string
                example: Bearer
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError401'
        '403':
          description: >-
            Forbidden. `error` is `additional_consent_required`
            (`request_additional_consent`), `client_deleted`
            (`contact_integration_owner`), `integration_not_approved`
            (`complete_integration_approval`), `integration_suspended`
            (`contact_integration_owner`), `linked_account_not_granted`
            (`grant_linked_account`), `missing_scope`
            (`request_additional_consent`), `security_suspended`
            (`contact_integration_owner`), `subscription_required`
            (`update_developer_plan`).
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError403'
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError404'
          description: >-
            Not Found. `error` is `linked_account_not_found`
            (`list_linked_accounts`). `linked_account_not_found`: not part of
            this authorization.
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountReconnectError409'
          description: >-
            Conflict. `error` is `linked_account_reconnect_not_required`,
            `linked_account_reconnect_unavailable`.
            `linked_account_reconnect_not_required`: already connected;
            `linked_account_reconnect_unavailable`: no provider reconnect
            journey is available.
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
        '429':
          description: >-
            Rate Limit Exceeded. `error` is `quota_exhausted`
            (`retry_after_reset`), `rate_limited` (`retry`).
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
            Retry-After:
              schema:
                type: string
                example: '3600'
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError429'
        '503':
          description: >-
            Service Unavailable. `error` is
            `authorization_temporarily_unavailable` (`retry`).
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError503'
      security:
        - ExternalOAuth: []
components:
  schemas:
    LinkedAccountReconnectRequest:
      additionalProperties: false
      properties:
        redirect_uri:
          format: uri
          maxLength: 4096
          type: string
        state:
          maxLength: 1024
          minLength: 1
          type: string
      required:
        - redirect_uri
        - state
      type: object
    LinkedAccountReconnectJourney:
      properties:
        authorization_id:
          type: string
        expires_at:
          type: string
          format: date-time
        linked_account_id:
          type: string
        url:
          format: uri
          type: string
      required:
        - url
        - expires_at
        - authorization_id
        - linked_account_id
      type: object
    LinkedAccountReconnectError400:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - properties:
            error:
              description: >-
                Stable error code: `invalid_redirect_uri` (`correct_request`),
                `invalid_request`.
              enum:
                - invalid_redirect_uri
                - invalid_request
              type: string
          type: object
    LinkedAccountsError401:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - authorization_required
                - external_oauth_bearer_required
                - grant_revoked_or_expired
                - invalid_token
              description: >-
                Stable error code: `authorization_required`
                (`restart_authorization`), `external_oauth_bearer_required`
                (`obtain_external_oauth_token`), `grant_revoked_or_expired`
                (`restart_authorization`), `invalid_token`
                (`obtain_external_oauth_token`).
    LinkedAccountsError403:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - additional_consent_required
                - client_deleted
                - integration_not_approved
                - integration_suspended
                - linked_account_not_granted
                - missing_scope
                - security_suspended
                - subscription_required
              description: >-
                Stable error code: `additional_consent_required`
                (`request_additional_consent`), `client_deleted`
                (`contact_integration_owner`), `integration_not_approved`
                (`complete_integration_approval`), `integration_suspended`
                (`contact_integration_owner`), `linked_account_not_granted`
                (`grant_linked_account`), `missing_scope`
                (`request_additional_consent`), `security_suspended`
                (`contact_integration_owner`), `subscription_required`
                (`update_developer_plan`).
    LinkedAccountsError404:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - properties:
            error:
              description: >-
                Stable error code: `linked_account_not_found`
                (`list_linked_accounts`).
              enum:
                - linked_account_not_found
              type: string
          type: object
    LinkedAccountReconnectError409:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - properties:
            error:
              description: >-
                Stable error code: `linked_account_reconnect_not_required`,
                `linked_account_reconnect_unavailable`.
              enum:
                - linked_account_reconnect_not_required
                - linked_account_reconnect_unavailable
              type: string
          type: object
    LinkedAccountsError429:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - quota_exhausted
                - rate_limited
              description: >-
                Stable error code: `quota_exhausted` (`retry_after_reset`),
                `rate_limited` (`retry`).
    LinkedAccountsError503:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - authorization_temporarily_unavailable
              description: >-
                Stable error code: `authorization_temporarily_unavailable`
                (`retry`).
    RuntimeError:
      type: object
      properties:
        error:
          type: string
          description: >-
            Stable error code. Each error response lists the codes its status
            can carry. `missing_scope` means the access token lacks the scope;
            `additional_consent_required` means the token has it but the linked
            account's current consent no longer covers it. Both recover with
            `request_additional_consent`.
          example: invalid_token
        recovery:
          type: object
          properties:
            action:
              type: string
              enum:
                - obtain_external_oauth_token
                - retry
                - retry_after_reset
                - restart_authorization
                - request_additional_consent
                - grant_linked_account
                - select_linked_account
                - reconnect_linked_account
                - list_linked_accounts
                - complete_integration_approval
                - contact_integration_owner
                - update_developer_plan
                - enable_vault_plus
                - enable_linked_account_vault_plus
                - correct_request
                - check_request
                - check_resource
                - do_not_repeat
                - restart_upload
              description: What to do before retrying.
          required:
            - action
          description: >-
            Absent on `invalid_request` and other errors with no recovery
            action.
        requestId:
          type: string
          example: 4f5c3f0e-8d7c-4ff5-9b7f-7d0d9e7c2a61
        message:
          type: string
          description: Human-readable detail, when available.
        details:
          type: string
          description: Upstream failure detail (Vault+ `502`).
        not_allowed_qualities:
          type: object
          properties:
            image_qualities:
              type: array
              items:
                type: string
                enum:
                  - thumb
                  - preview
                  - full
            video_qualities:
              type: array
              items:
                type: string
                enum:
                  - preview
                  - 720p
                  - 1080p
                  - source
          required:
            - image_qualities
            - video_qualities
          description: >-
            `vault_plus_quality_not_in_plan`: the requested qualities your
            Developer plan does not include.
        allowed_qualities:
          type: object
          properties:
            image_qualities:
              type: array
              items:
                type: string
                enum:
                  - thumb
                  - preview
                  - full
            video_qualities:
              type: array
              items:
                type: string
                enum:
                  - preview
                  - 720p
                  - 1080p
                  - source
          required:
            - image_qualities
            - video_qualities
          description: >-
            `vault_plus_quality_not_in_plan`: the qualities your Developer plan
            includes.
      required:
        - error
        - requestId
  securitySchemes:
    ExternalOAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: Link access token for one Sandbox, Test, or Live authorization.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.