Connection Status
Connections move through different states as they are created and used.
Status Values
CREATED
Initial state. Widget token issued, waiting for user to submit credentials.
CREDENTIALS_SUBMITTED
User submitted credentials. Queued for verification.
VERIFYING
Worker is attempting to log in to the bank.
CONNECTED
Success! Accounts and transactions are available.
MFA_REQUIRED
Bank requires additional verification (e.g., SMS code).
FAILED_AUTH
Invalid credentials. User can retry with correct credentials.
ERROR
Unexpected failure (bank unavailable, timeout, etc.).
DISCONNECTED
Terminal state. User or fintech disconnected the account.
💡 Tip
Use webhooks to know when a connection becomes CONNECTED or encounters an error.