Build a custom authentication flow using passkeys

Enable passkeys
1. Domain restrictions for passkeys
Create user passkeys
Sign a user in with a passkey
Rename user passkeys
Delete user passkeys

Warning

This guide is for users who want to build a custom flow. To use a prebuilt UI, use the Account Portal pages or prebuilt components.

Clerk supports passwordless authentication via passkeys, enabling users to sign in without having to remember a password. Instead, users select a passkey associated with their device, which they can use to authenticate themselves.

This guide demonstrates how to use the Clerk API to build a custom user interface for creating, signing users in with, and managing passkeys.

Enable passkeys

To use passkeys, first enable the strategy in the Clerk Dashboard.

When setting up passkeys with Android, there are a few additional steps to follow. Learn more about passkeys for Android.

When setting up passkeys with Expo, there are a few additional steps to follow. Learn more about passkeys for Expo.

Domain restrictions for passkeys

Passkeys are tied to the domain they are created on and cannot be used across different domains. However, passkeys do work on subdomains if they are registered on the root domain. For example:

Passkeys created on your-domain.com cannot be used on your-domain-admin.com (different domains).
Passkeys created on your-domain.com can be used on accounts.your-domain.com (subdomain of the same root domain).
Passkeys created on staging1.your-domain.com cannot be used on staging2.your-domain.com (sibling subdomains) unless the passkey was scoped to your-domain.com (i.e. the shared root domain).

If you're using satellite domains, in both development and production, passkeys won't be portable between your primary domain and your satellite domains so you should avoid using them.

If you're not using satellite domains:

In development, you can either:
- The recommended approach. Use Clerk's components, Elements, or custom flows, instead of the Account Portal. This ensures the passkey is created and used entirely on your development domain, so passkeys created on localhost will only work on localhost.
- Create a passkey directly through the Account Portal instead of your local application to keep it tied to the Account Portal's domain. Passkeys created on your Account Portal (e.g., your-app.accounts.dev) will only work on that domain, which can cause issues if you switch between localhost and the Account Portal during development. If you choose this approach, ensure all testing happens on the same domain where the passkey was created.
In production, your Account Portal is usually hosted on a subdomain of your main domain (e.g. accounts.your-domain.com), enabling passkeys to work seamlessly across your app. However, as stated above, if you use satellite domains, passkeys will not work as intended.

Create user passkeys

Tip

Examples for this SDK aren't available yet. For now, try adapting the available example to fit your SDK.

To create a passkey for a user, you must call User.createPasskey(), as shown in the following example:

components/CustomCreatePasskeysButton.tsx

export function CreatePasskeyButton() {
  const { isSignedIn, user } = useUser()

  const createClerkPasskey = async () => {
    if (!isSignedIn) {
      // Handle signed out state
      return
    }

    try {
      await user?.createPasskey()
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
    }
  }

  return <button onClick={createClerkPasskey}>Create a passkey</button>
}

app/components/create-passkeys-button.tsx

import { ThemedText } from '@/components/themed-text'
import { useUser } from '@clerk/expo'
import { Pressable, StyleSheet } from 'react-native'

export function CreatePasskeyButton() {
  const { isSignedIn, user } = useUser()

  const createClerkPasskey = async () => {
    if (!isSignedIn) {
      return
    }

    try {
      await user?.createPasskey()
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
    }
  }

  return (
    <Pressable
      style={({ pressed }) => [
        styles.button,
        !isSignedIn && styles.buttonDisabled,
        pressed && styles.buttonPressed,
      ]}
      onPress={createClerkPasskey}
      disabled={!isSignedIn}
    >
      <ThemedText style={styles.buttonText}>Create a passkey</ThemedText>
    </Pressable>
  )
}

const styles = StyleSheet.create({
  button: {
    backgroundColor: '#0a7ea4',
    paddingVertical: 12,
    paddingHorizontal: 24,
    borderRadius: 8,
    alignItems: 'center',
  },
  buttonPressed: {
    opacity: 0.7,
  },
  buttonDisabled: {
    opacity: 0.5,
  },
  buttonText: {
    color: '#fff',
    fontWeight: '600',
  },
})

CreatePasskeyView.swift

import SwiftUI
import ClerkKit

struct CreatePasskeyView: View {
  @Environment(Clerk.self) private var clerk

  var body: some View {
    Button("Create a passkey") {
      Task { await createPasskey() }
    }
  }
}

extension CreatePasskeyView {

  func createPasskey() async {
    guard let user = clerk.user else { return }

    do {
      _ = try await user.createPasskey()
    } catch {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      dump(error)
    }
  }
}

import com.clerk.api.Clerk
import com.clerk.api.network.serialization.onFailure
import com.clerk.api.network.serialization.onSuccess
import com.clerk.api.user.createPasskey

suspend fun createPasskey() {
  val user = Clerk.user ?: return

  user
    .createPasskey()
    .onSuccess {
      // Passkey created
    }
    .onFailure {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
    }
}

Sign a user in with a passkey

Tip

Examples for this SDK aren't available yet. For now, try adapting the available example to fit your SDK.

To sign a user into your Clerk app with a passkey, you must call SignIn.authenticateWithPasskey(). This method allows users to choose from their discoverable passkeys, such as hardware keys or passkeys in password managers.

components/SignInWithPasskeyButton.tsx

export function SignInWithPasskeyButton() {
  const { signIn } = useSignIn()
  const router = useRouter()

  const signInWithPasskey = async () => {
    // 'discoverable' lets the user choose a passkey
    // without auto-filling any of the options
    try {
      await signIn.passkey({ flow: 'discoverable' })

      if (signIn.status === 'complete') {
        await signIn.finalize({
          navigate: async ({ session, decorateUrl }) => {
            if (session?.currentTask) {
              //  Handle pending session tasks
              // See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
              console.log(session?.currentTask)
              return
            }

            const url = decorateUrl('/')
            if (url.startsWith('http')) {
              window.location.href = url
            } else {
              router.push(url)
            }
          },
        })
      } else {
        // If the status is not complete, check why. User may need to
        // complete further steps.
        console.error(JSON.stringify(signInAttempt, null, 2))
      }
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
    }
  }

  return <button onClick={signInWithPasskey}>Sign in with a passkey</button>
}

app/components/sign-in-with-passkey-button.tsx

import { ThemedText } from '@/components/themed-text'
import { useSignIn } from '@clerk/expo'
import { type Href, useRouter } from 'expo-router'
import { Pressable, StyleSheet } from 'react-native'

export function SignInWithPasskeyButton() {
  const { signIn } = useSignIn()
  const router = useRouter()

  const signInWithPasskey = async () => {
    // 'discoverable' lets the user choose a passkey
    // without auto-filling any of the options
    try {
      await signIn.passkey({ flow: 'discoverable' })

      if (signIn.status === 'complete') {
        await signIn.finalize({
          navigate: async ({ session, decorateUrl }) => {
            if (session?.currentTask) {
              //  Handle pending session tasks
              // See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
              console.log(session?.currentTask)
              return
            }

            const url = decorateUrl('/')
            if (url.startsWith('http')) {
              window.location.href = url
            } else {
              router.push(url as Href)
            }
          },
        })
      } else {
        // If the status is not complete, check why. User may need to
        // complete further steps.
        console.error(JSON.stringify(signIn.status, null, 2))
      }
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
    }
  }

  return (
    <Pressable
      style={({ pressed }) => [styles.button, pressed && styles.buttonPressed]}
      onPress={signInWithPasskey}
    >
      <ThemedText style={styles.buttonText}>Sign in with a passkey</ThemedText>
    </Pressable>
  )
}

const styles = StyleSheet.create({
  button: {
    backgroundColor: '#0a7ea4',
    paddingVertical: 12,
    paddingHorizontal: 24,
    borderRadius: 8,
    alignItems: 'center',
    marginTop: 8,
  },
  buttonPressed: {
    opacity: 0.7,
  },
  buttonText: {
    color: '#fff',
    fontWeight: '600',
  },
})

SignInWithPasskeyView.swift

import SwiftUI
import ClerkKit

struct SignInWithPasskeyView: View {
  @Environment(Clerk.self) private var clerk

  var body: some View {
    Button("Sign in with a passkey") {
      Task { await signInWithPasskey() }
    }
  }
}

extension SignInWithPasskeyView {

  func signInWithPasskey() async {
    do {
      let signIn = try await clerk.auth.signInWithPasskey()
      let result = try await signIn.authenticateWithPasskey()

      if result.status == .complete {
        dump(clerk.session)
      } else {
        dump(result.status)
      }
    } catch {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      dump(error)
    }
  }
}

import com.clerk.api.Clerk
import com.clerk.api.auth.signInWithPasskey
import com.clerk.api.network.serialization.onFailure
import com.clerk.api.network.serialization.onSuccess
import com.clerk.api.signin.SignIn

suspend fun signInWithPasskey() {
  Clerk.auth
    .signInWithPasskey()
    .onSuccess { signIn ->
      if (signIn.status == SignIn.Status.COMPLETE && signIn.createdSessionId != null) {
        Clerk.auth
          .setActive(sessionId = signIn.createdSessionId)
          .onFailure {
            // See https://clerk.com/docs/guides/development/custom-flows/error-handling
            // for more info on error handling
          }
      }
    }
    .onFailure {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
    }
}

Rename user passkeys

Clerk generates a name based on the device associated with the passkey when it's created. Sometimes users may want to rename a passkey to make it easier to identify. To rename a user's passkey, you must call the update() method of the passkey object, as shown in the following example:

Tip

Examples for this SDK aren't available yet. For now, try adapting the available example to fit your SDK.

components/RenamePasskeyUI.tsx

export function RenamePasskeyUI() {
  const { user } = useUser()
  const { passkeys } = user

  const passkeyToUpdateId = useRef<HTMLInputElement>(null)
  const newPasskeyName = useRef<HTMLInputElement>(null)
  const [success, setSuccess] = useState(false)

  const renamePasskey = async () => {
    try {
      const passkeyToUpdate = passkeys?.find(
        (pk: PasskeyResource) => pk.id === passkeyToUpdateId.current?.value,
      )

      await passkeyToUpdate?.update({
        name: newPasskeyName.current?.value,
      })

      setSuccess(true)
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
      setSuccess(false)
    }
  }

  return (
    <>
      <p>Passkeys:</p>
      <ul>
        {passkeys?.map((pk: PasskeyResource) => {
          return (
            <li key={pk.id}>
              Name: {pk.name} | ID: {pk.id}
            </li>
          )
        })}
      </ul>
      <input ref={passkeyToUpdateId} type="text" placeholder="Enter the passkey ID" />
      <input type="text" placeholder="Enter the passkey's new name" ref={newPasskeyName} />
      <button onClick={renamePasskey}>Rename passkey</button>
      <p>Passkey updated: {success ? 'Yes' : 'No'}</p>
    </>
  )
}

app/components/rename-passkey.tsx

import { ThemedText } from '@/components/themed-text'
import { ThemedView } from '@/components/themed-view'
import { useUser } from '@clerk/expo'
import { PasskeyResource } from '@clerk/shared/types'
import { useState } from 'react'
import { FlatList, Pressable, StyleSheet, TextInput, View } from 'react-native'

export function RenamePasskeyUI() {
  const { user } = useUser()
  const passkeys = user?.passkeys

  const [passkeyToUpdateId, setPasskeyToUpdateId] = useState('')
  const [newPasskeyName, setNewPasskeyName] = useState('')
  const [success, setSuccess] = useState(false)

  const renamePasskey = async () => {
    try {
      const passkeyToUpdate = passkeys?.find((pk: PasskeyResource) => pk.id === passkeyToUpdateId)

      await passkeyToUpdate?.update({
        name: newPasskeyName,
      })

      setSuccess(true)
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
      setSuccess(false)
    }
  }

  return (
    <ThemedView style={styles.container}>
      <ThemedText type="subtitle" style={styles.sectionTitle}>
        Passkeys:
      </ThemedText>

      {passkeys && passkeys.length > 0 ? (
        <FlatList
          data={passkeys}
          scrollEnabled={false}
          keyExtractor={(item) => item.id}
          renderItem={({ item: pk }) => (
            <View style={styles.passkeyCard}>
              <ThemedText style={styles.passkeyText}>
                Name: {pk.name} | ID: {pk.id}
              </ThemedText>
            </View>
          )}
          style={styles.list}
        />
      ) : (
        <ThemedText style={styles.infoText}>No passkeys available</ThemedText>
      )}

      <ThemedText style={styles.label}>Enter the passkey ID</ThemedText>
      <TextInput
        style={styles.input}
        value={passkeyToUpdateId}
        placeholder="Enter the passkey ID"
        placeholderTextColor="#666666"
        onChangeText={setPasskeyToUpdateId}
      />

      <ThemedText style={styles.label}>Enter the passkey's new name</ThemedText>
      <TextInput
        style={styles.input}
        value={newPasskeyName}
        placeholder="Enter the passkey's new name"
        placeholderTextColor="#666666"
        onChangeText={setNewPasskeyName}
      />

      <Pressable
        style={({ pressed }) => [
          styles.button,
          (!passkeyToUpdateId || !newPasskeyName) && styles.buttonDisabled,
          pressed && styles.buttonPressed,
        ]}
        onPress={renamePasskey}
        disabled={!passkeyToUpdateId || !newPasskeyName}
      >
        <ThemedText style={styles.buttonText}>Rename passkey</ThemedText>
      </Pressable>

      <View
        style={[
          styles.statusContainer,
          success ? styles.successContainer : styles.neutralContainer,
        ]}
      >
        <ThemedText style={success ? styles.successText : styles.neutralText}>
          Passkey updated: {success ? 'Yes' : 'No'}
        </ThemedText>
      </View>
    </ThemedView>
  )
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    padding: 20,
    gap: 12,
  },
  sectionTitle: {
    fontWeight: '600',
    fontSize: 16,
    marginBottom: 8,
  },
  list: {
    marginBottom: 16,
  },
  passkeyCard: {
    padding: 12,
    backgroundColor: '#f5f5f5',
    borderRadius: 8,
    marginBottom: 8,
  },
  passkeyText: {
    fontSize: 14,
    fontFamily: 'monospace',
  },
  infoText: {
    fontSize: 14,
    opacity: 0.8,
    marginBottom: 16,
  },
  label: {
    fontWeight: '600',
    fontSize: 14,
  },
  input: {
    borderWidth: 1,
    borderColor: '#ccc',
    borderRadius: 8,
    padding: 12,
    fontSize: 16,
    backgroundColor: '#fff',
  },
  button: {
    backgroundColor: '#0a7ea4',
    paddingVertical: 12,
    paddingHorizontal: 24,
    borderRadius: 8,
    alignItems: 'center',
    marginTop: 8,
  },
  buttonPressed: {
    opacity: 0.7,
  },
  buttonDisabled: {
    opacity: 0.5,
  },
  buttonText: {
    color: '#fff',
    fontWeight: '600',
  },
  statusContainer: {
    padding: 12,
    borderRadius: 8,
    marginTop: 8,
  },
  successContainer: {
    backgroundColor: '#e8f5e9',
  },
  neutralContainer: {
    backgroundColor: '#f5f5f5',
  },
  successText: {
    color: '#2e7d32',
    fontWeight: '500',
  },
  neutralText: {
    color: '#666',
    fontWeight: '500',
  },
})

RenamePasskeyView.swift

import SwiftUI
import ClerkKit

struct RenamePasskeyView: View {
  @Environment(Clerk.self) private var clerk
  @State private var passkeyId = ""
  @State private var newName = ""

  var body: some View {
    VStack {
      TextField("Enter passkey ID", text: $passkeyId)
      TextField("Enter passkey's new name", text: $newName)
      Button("Rename passkey") {
        Task { await renamePasskey(passkeyId: passkeyId, newName: newName) }
      }
    }
  }
}

extension RenamePasskeyView {

  func renamePasskey(passkeyId: String, newName: String) async {
    guard
      let passkey = clerk.user?.passkeys.first(where: { $0.id == passkeyId })
    else { return }

    do {
      _ = try await passkey.update(name: newName)
    } catch {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      dump(error)
    }
  }
}

import com.clerk.api.Clerk
import com.clerk.api.network.serialization.onFailure
import com.clerk.api.network.serialization.onSuccess
import com.clerk.api.passkeys.update

suspend fun renamePasskey(passkeyId: String, newName: String) {
  val passkey = Clerk.user?.passkeys?.firstOrNull { it.id == passkeyId } ?: return

  passkey
    .update(name = newName)
    .onSuccess {
      // Passkey renamed
    }
    .onFailure {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
    }
}

Delete user passkeys

To delete a user's passkey from your Clerk app, you must call the delete() method of the passkey object, as shown in the following example:

Tip

Examples for this SDK aren't available yet. For now, try adapting the available example to fit your SDK.

components/DeletePasskeyUI.tsx

export function DeletePasskeyUI() {
  const { user } = useUser()
  const { passkeys } = user

  const passkeyToDeleteId = useRef<HTMLInputElement>(null)
  const [success, setSuccess] = useState(false)

  const deletePasskey = async () => {
    const passkeyToDelete = passkeys?.find((pk: any) => pk.id === passkeyToDeleteId.current?.value)
    try {
      await passkeyToDelete?.delete()

      setSuccess(true)
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
      setSuccess(false)
    }
  }

  return (
    <>
      <p>Passkeys:</p>
      <ul>
        {passkeys?.map((pk: any) => {
          return (
            <li key={pk.id}>
              Name: {pk.name} | ID: {pk.id}
            </li>
          )
        })}
      </ul>
      <input ref={passkeyToDeleteId} type="text" placeholder="Enter the passkey ID" />
      <button onClick={deletePasskey}>Delete passkey</button>
      <p>Passkey deleted: {success ? 'Yes' : 'No'}</p>
    </>
  )
}

app/components/delete-passkey.tsx

import { ThemedText } from '@/components/themed-text'
import { ThemedView } from '@/components/themed-view'
import { useUser } from '@clerk/expo'
import { PasskeyResource } from '@clerk/shared/types'
import { useState } from 'react'
import { FlatList, Pressable, StyleSheet, TextInput, View } from 'react-native'

export function DeletePasskeyUI() {
  const { user } = useUser()
  const passkeys = user?.passkeys

  const [passkeyToDeleteId, setPasskeyToDeleteId] = useState('')
  const [success, setSuccess] = useState(false)

  const deletePasskey = async () => {
    const passkeyToDelete = passkeys?.find((pk: PasskeyResource) => pk.id === passkeyToDeleteId)
    try {
      await passkeyToDelete?.delete()

      setSuccess(true)
    } catch (err) {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      console.error('Error:', JSON.stringify(err, null, 2))
      setSuccess(false)
    }
  }

  return (
    <ThemedView style={styles.container}>
      <ThemedText type="subtitle" style={styles.sectionTitle}>
        Passkeys:
      </ThemedText>

      {passkeys && passkeys.length > 0 ? (
        <FlatList
          data={passkeys}
          scrollEnabled={false}
          keyExtractor={(item) => item.id}
          renderItem={({ item: pk }) => (
            <View style={styles.passkeyCard}>
              <ThemedText style={styles.passkeyText}>
                Name: {pk.name} | ID: {pk.id}
              </ThemedText>
            </View>
          )}
          style={styles.list}
        />
      ) : (
        <ThemedText style={styles.infoText}>No passkeys available</ThemedText>
      )}

      <ThemedText style={styles.label}>Enter the passkey ID</ThemedText>
      <TextInput
        style={styles.input}
        value={passkeyToDeleteId}
        placeholder="Enter the passkey ID"
        placeholderTextColor="#666666"
        onChangeText={setPasskeyToDeleteId}
      />

      <Pressable
        style={({ pressed }) => [
          styles.button,
          styles.dangerButton,
          !passkeyToDeleteId && styles.buttonDisabled,
          pressed && styles.buttonPressed,
        ]}
        onPress={deletePasskey}
        disabled={!passkeyToDeleteId}
      >
        <ThemedText style={styles.buttonText}>Delete passkey</ThemedText>
      </Pressable>

      <View
        style={[
          styles.statusContainer,
          success ? styles.successContainer : styles.neutralContainer,
        ]}
      >
        <ThemedText style={success ? styles.successText : styles.neutralText}>
          Passkey deleted: {success ? 'Yes' : 'No'}
        </ThemedText>
      </View>
    </ThemedView>
  )
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    padding: 20,
    gap: 12,
  },
  sectionTitle: {
    fontWeight: '600',
    fontSize: 16,
    marginBottom: 8,
  },
  list: {
    marginBottom: 16,
  },
  passkeyCard: {
    padding: 12,
    backgroundColor: '#f5f5f5',
    borderRadius: 8,
    marginBottom: 8,
  },
  passkeyText: {
    fontSize: 14,
    fontFamily: 'monospace',
  },
  infoText: {
    fontSize: 14,
    opacity: 0.8,
    marginBottom: 16,
  },
  label: {
    fontWeight: '600',
    fontSize: 14,
  },
  input: {
    borderWidth: 1,
    borderColor: '#ccc',
    borderRadius: 8,
    padding: 12,
    fontSize: 16,
    backgroundColor: '#fff',
  },
  button: {
    backgroundColor: '#0a7ea4',
    paddingVertical: 12,
    paddingHorizontal: 24,
    borderRadius: 8,
    alignItems: 'center',
    marginTop: 8,
  },
  dangerButton: {
    backgroundColor: '#c62828',
  },
  buttonPressed: {
    opacity: 0.7,
  },
  buttonDisabled: {
    opacity: 0.5,
  },
  buttonText: {
    color: '#fff',
    fontWeight: '600',
  },
  statusContainer: {
    padding: 12,
    borderRadius: 8,
    marginTop: 8,
  },
  successContainer: {
    backgroundColor: '#e8f5e9',
  },
  neutralContainer: {
    backgroundColor: '#f5f5f5',
  },
  successText: {
    color: '#2e7d32',
    fontWeight: '500',
  },
  neutralText: {
    color: '#666',
    fontWeight: '500',
  },
})

DeletePasskeyView.swift

import SwiftUI
import ClerkKit

struct DeletePasskeyView: View {
  @Environment(Clerk.self) private var clerk
  @State private var passkeyId = ""

  var body: some View {
    VStack {
      TextField("Enter passkey ID", text: $passkeyId)
      Button("Delete passkey") {
        Task { await deletePasskey(passkeyId: passkeyId) }
      }
    }
  }
}

extension DeletePasskeyView {

  func deletePasskey(passkeyId: String) async {
    guard
      let passkey = clerk.user?.passkeys.first(where: { $0.id == passkeyId })
    else { return }

    do {
      _ = try await passkey.delete()
    } catch {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
      dump(error)
    }
  }
}

import com.clerk.api.Clerk
import com.clerk.api.network.serialization.onFailure
import com.clerk.api.network.serialization.onSuccess
import com.clerk.api.passkeys.delete

suspend fun deletePasskey(passkeyId: String) {
  val passkey = Clerk.user?.passkeys?.firstOrNull { it.id == passkeyId } ?: return

  passkey
    .delete()
    .onSuccess {
      // Passkey deleted
    }
    .onFailure {
      // See https://clerk.com/docs/guides/development/custom-flows/error-handling
      // for more info on error handling
    }
}

Last updated on Mar 10, 2026

Edit on GitHub

Build a custom authentication flow using passkeys

Enable passkeys

Domain restrictions for passkeys

Create user passkeys

Sign a user in with a passkey

Rename user passkeys

Delete user passkeys

Feedback