AccountSelectionRequired

Job status

Connecting

AccountSelectionRequired indicates that the session has successfully passed all authentication steps, but cannot proceed until the end user selects which account(s) should be scraped.
This requirement is based on the connection's configuration, not the number of accounts detected on the provider’s portal.


Implications:

  • The session is on hold, awaiting user input.
  • No data can be retrieved until the account selection is completed.
  • The session cannot progress to ConnectedCredentials or data extraction unless a valid account selection is made.

Why this status appears:

The customer (i.e., the integrator of the Deck API) configures the connection with an account selection strategy:

  • all: All accounts will be selected automatically — this status will not appear.
  • single: The end user must select exactly one account to continue.
  • multiple: The end user must select one or more accounts manually.

If the user makes no selection, the session will remain stuck in this state or eventually expire.


Expected Developer Action

  • Prompt the user to choose the account(s) they wish to connect.
  • Ensure the selection meets the requirements of the connection's configuration (single vs. multiple).
  • Submit the account selection to Deck to allow the session to continue.

Additional Notes:

  • This status appears after all authentication steps (e.g., MFA, security questions) but before ConnectedCredentials.
  • Failure to act will eventually result in session timeout (e.g., SecurityAnswerTimeout or similar idle-ending state).