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

# Passkey Creation: After Passkey Login Error

> This flow details how a user appends a new passkey after they faced an error when logging in with an existing passkey (autohealing).

## Passkey Creation after Error

Users logging into desktop and mobile web apps may experience an error during passkey login, need to use conventional login methods, and can then append a new passkey. This flow provides an intelligent recovery mechanism for various scenarios.

### Common Scenarios Leading to Passkey Login Errors

Passkey login errors can occur in several situations:

* **Locally deleted passkeys**: The user has deleted their passkey from their device or password manager
* **Different cloud account**: The user is logged into a similar device they've used before, but it's now connected to a different iCloud account (or different Google account on Android)
* **Logged-out password manager**: The user has signed out of their password manager that stored the passkey

### How Passkey Intelligence Enables Auto-Healing

**[Passkey Intelligence](/corbado-connect/features/passkey-intelligence)** monitors the authentication flow and detects when passkey login fails repeatedly. After the user successfully authenticates via traditional methods, it automatically suggests creating a new passkey to heal the broken authentication state. This smart system helps identify underlying account or device synchronization issues while ensuring users can quickly recover access.

<Tip>
  This autohealing mechanism is part of a broader [passkey fallback and recovery strategy](https://www.corbado.com/blog/passkey-fallback-recovery). Learn more about designing resilient authentication systems that handle passkey errors gracefully while maintaining security.
</Tip>

<Tabs>
  <Tab title="macOS" />

  <Tab title="Windows" />

  <Tab title="iOS" />

  <Tab title="Android" />
</Tabs>

<Steps>
  <Step title="User enters identifier">
    * User enters their identifier (email/username) on the login page.
    * System now knows which user account is attempting to log in.
  </Step>

  <Step title="Passkey Intelligence detects existing passkey">
    * [Passkey Intelligence](/corbado-connect/features/passkey-intelligence) analyzes the user's passkey availability.
    * It detects the user has a passkey registered and automatically initiates passkey login.
  </Step>

  <Step title="Passkey login errors occur">
    * User encounters one or more passkey login errors.
    * Common causes: deleted passkey, different cloud account, logged-out password manager.
    * System recognizes repeated login failures.
  </Step>

  <Step title="Fallback to traditional login method">
    * After multiple failed passkey login attempts, system falls back to traditional login method (username + password).
    * User successfully logs in using their password.
  </Step>

  <Step title="Autohealing: Passkey append initiates">
    * [Passkey Intelligence](/corbado-connect/features/passkey-intelligence) detects the broken passkey situation and triggers autohealing.
    * User is offered an option to create a new passkey to replace the broken one.
  </Step>

  <Step title="OS-native modal overlay">
    * User continues to set up a new passkey using fingerprint, face, or PIN for secure sign-in.
  </Step>

  <Step title="Passkey creation successful (healing complete)">
    * User successfully creates a new passkey, replacing the broken one.
    * The account is now healed with a working passkey.
  </Step>

  <Step title="Redirection to app dashboard">
    * User is redirected to the app dashboard.
  </Step>
</Steps>