# Application Logs

The [**Application Logs**](https://dashboard.clerk.com/~/application-logs) page of the Clerk Dashboard provides a detailed audit trail of events that occur within your instance. Application Logs track actions such as sign-ins, sign-ups, user updates, Organization changes, and more — enabling debugging, compliance, and observability.

To learn how to filter entries, inspect event details, and understand retention, see the [Logs overview](https://clerk.com/docs/guides/dashboard/logs/overview.md).

## Supported events

The following tables list all event types that can appear in Application Logs, organized by category. Use these identifiers when filtering logs in the Clerk Dashboard.

### Sign-up events

| Event type                           | Description                                |
| ------------------------------------ | ------------------------------------------ |
| `sign_up.completed`                  | Sign-up was completed                      |
| `sign_up.created`                    | Sign-up was created                        |
| `sign_up.email_address.created`      | Email address was added to sign-up         |
| `sign_up.external_account.connected` | External account was connected for sign-up |
| `sign_up.failed`                     | Sign-up failed                             |
| `sign_up.invitation.accepted`        | Invitation was accepted for sign-up        |
| `sign_up.legal_accepted`             | Legal terms were accepted for sign-up      |
| `sign_up.password.created`           | Password was added to sign-up              |
| `sign_up.phone_number.created`       | Phone number was added to sign-up          |
| `sign_up.saml_account.connected`     | SAML account was connected for sign-up     |
| `sign_up.unsafe_metadata.created`    | Unsafe metadata was added to sign-up       |
| `sign_up.updated`                    | Sign-up was updated                        |
| `sign_up.username.created`           | Username was added to sign-up              |
| `sign_up.web3_wallet.created`        | Web3 wallet was added to sign-up           |

#### Enumeration events

| Event type                                 | Description                                   |
| ------------------------------------------ | --------------------------------------------- |
| `sign_up.enumeration_target.email_address` | Sign-up attempted with existing email address |
| `sign_up.enumeration_target.phone_number`  | Sign-up attempted with existing phone number  |
| `sign_up.enumeration_target.username`      | Sign-up attempted with existing username      |
| `sign_up.enumeration_target.web3_wallet`   | Sign-up attempted with existing web3 wallet   |

#### Verification events

| Event type                                                | Description                                                                                                                 |
| --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `sign_up.email_address.verification.code_attempt_invalid` | Invalid verification email code attempt for sign-up                                                                         |
| `sign_up.email_address.verification.code_sent`            | Verification email code was sent for sign-up                                                                                |
| `sign_up.email_address.verification.link_sent`            | Verification email link was sent for sign-up                                                                                |
| `sign_up.email_address.verified`                          | Email address was verified for sign-up                                                                                      |
| `sign_up.phone_number.verification.code_attempt_invalid`  | Invalid verification phone code attempt for sign-up                                                                         |
| `sign_up.phone_number.verification.code_attempt_rejected` | Verification phone code attempt for sign-up was rejected before the code was checked (for example, the code was never sent) |
| `sign_up.phone_number.verification.code_sent`             | Verification phone code was sent for sign-up                                                                                |
| `sign_up.phone_number.verified`                           | Phone number was verified for sign-up                                                                                       |

#### CAPTCHA events

| Event type                 | Description              |
| -------------------------- | ------------------------ |
| `sign_up.captcha.failed`   | Sign-up CAPTCHA failed   |
| `sign_up.captcha.passed`   | Sign-up CAPTCHA passed   |
| `sign_up.captcha.required` | Sign-up requires CAPTCHA |
| `sign_up.captcha.skipped`  | Sign-up CAPTCHA skipped  |

### Sign-in events

| Event type                               | Description                                                 |
| ---------------------------------------- | ----------------------------------------------------------- |
| `sign_in.already_signed_in`              | Sign-in was rejected because user is already signed in      |
| `sign_in.completed`                      | Sign-in was completed                                       |
| `sign_in.created`                        | Sign-in was created                                         |
| `sign_in.enterprise_connection_required` | Sign-in was rejected — must use enterprise connection email |
| `sign_in.failed`                         | Sign-in failed                                              |
| `sign_in.identifier_blocked`             | Sign-in was blocked by allowlist/blocklist                  |
| `sign_in.invitation.accepted`            | Invitation was accepted for sign-in                         |
| `sign_in.transfer.completed`             | Sign-in was completed via transfer                          |
| `sign_in.user_locked`                    | Sign-in was blocked because user is locked                  |

#### Password events

| Event type                     | Description                                                                     |
| ------------------------------ | ------------------------------------------------------------------------------- |
| `sign_in.password.compromised` | Password flagged for mandatory reset by admin or instance policy during sign-in |
| `sign_in.password.failed`      | Password attempt failed during sign-in                                          |
| `sign_in.password.pwned`       | Password found in public breach database (HIBP) during sign-in                  |

#### Verification events

| Event type                                                | Description                                                                                                                 |
| --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `sign_in.email_address.verification.code_attempt_invalid` | Invalid verification email code attempt for sign-in                                                                         |
| `sign_in.email_address.verification.code_sent`            | Verification email code was sent for sign-in                                                                                |
| `sign_in.email_address.verification.link_sent`            | Verification email link was sent for sign-in                                                                                |
| `sign_in.email_address.verified`                          | Email address was verified for sign-in                                                                                      |
| `sign_in.phone_number.verification.code_attempt_invalid`  | Invalid verification phone code attempt for sign-in                                                                         |
| `sign_in.phone_number.verification.code_attempt_rejected` | Verification phone code attempt for sign-in was rejected before the code was checked (for example, the code was never sent) |
| `sign_in.phone_number.verification.code_sent`             | Verification phone code was sent for sign-in                                                                                |
| `sign_in.phone_number.verified`                           | Phone number was verified for sign-in                                                                                       |
| `sign_in.web3_signature.failed`                           | Web3 signature verification failed during sign-in                                                                           |

#### Factor events

| Event type                             | Description                                    |
| -------------------------------------- | ---------------------------------------------- |
| `sign_in.attempt_first_factor.failed`  | First factor attempt failed                    |
| `sign_in.attempt_first_factor.passed`  | First factor attempt passed                    |
| `sign_in.attempt_second_factor.failed` | Second factor attempt failed                   |
| `sign_in.attempt_second_factor.passed` | Second factor attempt passed                   |
| `sign_in.prepare_first_factor.failed`  | First factor preparation failed                |
| `sign_in.prepare_first_factor.passed`  | First factor preparation passed                |
| `sign_in.prepare_second_factor.failed` | Second factor preparation failed               |
| `sign_in.prepare_second_factor.passed` | Second factor preparation passed               |
| `sign_in.sso_bypass.succeeded`         | Enterprise SSO was bypassed with an email code |

#### Client Trust events

| Event type                      | Description                                                                                                                    |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `sign_in.client_trust.passed`   | User verified their email address or phone number, establishing trust for an unrecognized device                               |
| `sign_in.client_trust.required` | Sign-in with a password from an unrecognized device requires verifying an email address or phone number before it can complete |

#### CAPTCHA events

| Event type                 | Description              |
| -------------------------- | ------------------------ |
| `sign_in.captcha.bypassed` | Sign-in CAPTCHA bypassed |
| `sign_in.captcha.failed`   | Sign-in CAPTCHA failed   |
| `sign_in.captcha.passed`   | Sign-in CAPTCHA passed   |
| `sign_in.captcha.required` | Sign-in requires CAPTCHA |

### User events

| Event type                        | Description                                   |
| --------------------------------- | --------------------------------------------- |
| `user.all_totps.deleted`          | All user TOTPs were deleted                   |
| `user.backup_codes.deleted`       | All user backup codes were deleted            |
| `user.banned`                     | User was banned                               |
| `user.created`                    | User was created                              |
| `user.credits.adjusted`           | User credits were adjusted                    |
| `user.deleted`                    | User was deleted                              |
| `user.locked`                     | User was locked                               |
| `user.metadata.updated`           | User metadata was updated                     |
| `user.mfa.disabled`               | User MFA was disabled                         |
| `user.password.verified`          | User password was verified                    |
| `user.password_compromised.set`   | User password marked as compromised           |
| `user.password_compromised.unset` | User password no longer marked as compromised |
| `user.totp_code.verified`         | User TOTP code was verified                   |
| `user.unbanned`                   | User was unbanned                             |
| `user.unlocked`                   | User was unlocked                             |
| `user.updated`                    | User was updated                              |

#### External account events

| Event type                                   | Description                                            |
| -------------------------------------------- | ------------------------------------------------------ |
| `user.external_account.connected`            | External account was connected to user account         |
| `user.external_account.connection_initiated` | External account connection initiated for user account |
| `user.external_account.disconnected`         | External account was disconnected from user account    |
| `user.external_account.reauthorized`         | External account was reauthorized for user account     |
| `user.external_account.token_revoked`        | External account token was revoked                     |

#### MFA events

| Event type                  | Description                                                |
| --------------------------- | ---------------------------------------------------------- |
| `user.backup_codes.created` | Backup codes were generated for user MFA recovery          |
| `user.mfa.enabled`          | MFA was enabled for user                                   |
| `user.totp.created`         | TOTP (authenticator app) setup was initiated for user      |
| `user.totp.deleted`         | TOTP (authenticator app) was removed from user account     |
| `user.totp.verified`        | TOTP (authenticator app) was verified and enabled for user |

#### Password events

| Event type                    | Description                 |
| ----------------------------- | --------------------------- |
| `user.password.change_failed` | User password change failed |
| `user.password.changed`       | User password was changed   |
| `user.password.deleted`       | User password was removed   |

#### Profile image events

| Event type                   | Description                    |
| ---------------------------- | ------------------------------ |
| `user.profile_image.deleted` | User profile image was deleted |
| `user.profile_image.updated` | User profile image was updated |

#### Passkey events

| Event type              | Description                           |
| ----------------------- | ------------------------------------- |
| `user.passkey.created`  | Passkey was created for user account  |
| `user.passkey.deleted`  | Passkey was deleted from user account |
| `user.passkey.updated`  | Passkey was updated for user account  |
| `user.passkey.verified` | Passkey was verified for user account |

### Session events

| Event type              | Description               |
| ----------------------- | ------------------------- |
| `session.created`       | Session was created       |
| `session.ended`         | Session ended             |
| `session.revoked`       | Session was revoked       |
| `session.token.created` | Session token was created |

#### Reverification events

| Event type                                            | Description                                                                                                                 |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `session.reverification.attempt_first_factor.failed`  | First factor attempt for session reverification failed                                                                      |
| `session.reverification.attempt_first_factor.passed`  | First factor attempt for session reverification passed                                                                      |
| `session.reverification.attempt_second_factor.failed` | Second factor attempt for session reverification failed                                                                     |
| `session.reverification.attempt_second_factor.passed` | Second factor attempt for session reverification passed                                                                     |
| `session.reverification.completed`                    | User completed reverifying their session                                                                                    |
| `session.reverification.prepare_first_factor.failed`  | First factor preparation for session reverification failed                                                                  |
| `session.reverification.prepare_first_factor.passed`  | First factor preparation for session reverification passed                                                                  |
| `session.reverification.prepare_second_factor.failed` | Second factor preparation for session reverification failed                                                                 |
| `session.reverification.prepare_second_factor.passed` | Second factor preparation for session reverification passed                                                                 |
| `session.reverification.required`                     | Request to a protected endpoint was rejected because the session had not been reverified, or its reverification had expired |
| `session.reverification.started`                      | User started reverifying their session                                                                                      |

### Device events

| Event type                    | Description                          |
| ----------------------------- | ------------------------------------ |
| `device.verified`             | Device was verified                  |
| `user.trusted_device.created` | Trusted device was added for user    |
| `user.trusted_device.revoked` | Trusted device was revoked from user |

### Protect events

| Event type                   | Description                                                     |
| ---------------------------- | --------------------------------------------------------------- |
| `protect.challenge.failed`   | Submitted Protect challenge was rejected                        |
| `protect.challenge.passed`   | Protect challenge was completed                                 |
| `protect.decision.shadowed`  | Protect would have blocked or challenged, but is in shadow mode |
| `protect.email.blocked`      | Email delivery was blocked by Protect                           |
| `protect.identifier.locked`  | Identifier was locked after too many failed attempts            |
| `protect.sign_in.blocked`    | Sign-in was blocked by Protect                                  |
| `protect.sign_in.challenged` | Protect issued a challenge during sign-in                       |
| `protect.sign_up.blocked`    | Sign-up was blocked by Protect                                  |
| `protect.sign_up.challenged` | Protect issued a challenge during sign-up                       |
| `protect.sms.blocked`        | SMS delivery was blocked by Protect                             |
| `protect.sms.challenged`     | Protect required a challenge before SMS delivery                |

### SCIM events

| Event type                      | Description                   |
| ------------------------------- | ----------------------------- |
| `scim.group_membership.changed` | SCIM group membership changed |
| `scim.provisioning_failed`      | SCIM provisioning failed      |
| `scim.user.created`             | SCIM user was created         |
| `scim.user.deleted`             | SCIM user was deleted         |
| `scim.user.patched`             | SCIM user was patched         |
| `scim.user.updated`             | SCIM user was updated         |

### Organization events

| Event type                      | Description                        |
| ------------------------------- | ---------------------------------- |
| `organization.created`          | Organization was created           |
| `organization.credits.adjusted` | Organization credits were adjusted |
| `organization.deleted`          | Organization was deleted           |
| `organization.logo.deleted`     | Organization logo was deleted      |
| `organization.logo.updated`     | Organization logo was updated      |
| `organization.metadata.updated` | Organization metadata was updated  |
| `organization.updated`          | Organization was updated           |

#### Membership events

| Event type                                 | Description                                   |
| ------------------------------------------ | --------------------------------------------- |
| `organization_membership.created`          | User was added as a member to an Organization |
| `organization_membership.deleted`          | User was removed from or left an Organization |
| `organization_membership.metadata.updated` | Organization membership metadata was updated  |
| `organization_membership.updated`          | Organization membership was updated           |

#### Invitation events

| Event type                         | Description                                      |
| ---------------------------------- | ------------------------------------------------ |
| `organization_invitation.accepted` | User accepted invitation to join an Organization |
| `organization_invitation.created`  | Organization invitation was created              |
| `organization_invitation.revoked`  | Organization invitation was revoked              |

#### Membership Request events

| Event type                                 | Description                                  |
| ------------------------------------------ | -------------------------------------------- |
| `organization_membership_request.accepted` | Organization Membership Request was accepted |
| `organization_membership_request.rejected` | Organization Membership Request was rejected |

#### Suggestion events

| Event type                         | Description                                      |
| ---------------------------------- | ------------------------------------------------ |
| `organization_suggestion.accepted` | User accepted suggestion to join an Organization |

#### Domain events

| Event type                                              | Description                                                      |
| ------------------------------------------------------- | ---------------------------------------------------------------- |
| `organization_domain.affiliation.verified`              | Organization domain affiliation was verified                     |
| `organization_domain.affiliation_verification.prepared` | Affiliation verification was prepared for an Organization domain |
| `organization_domain.created`                           | Domain was added to an Organization                              |
| `organization_domain.deleted`                           | Domain was removed from an Organization                          |
| `organization_domain.enrollment_mode.updated`           | Enrollment mode was updated for an Organization domain           |
| `organization_domain.ownership_verified`                | Ownership of an Organization domain was verified                 |
| `organization_domain.updated`                           | Organization domain was updated                                  |

### Billing events

| Event type                                                | Description                                                   |
| --------------------------------------------------------- | ------------------------------------------------------------- |
| `organization.checkout.confirmed`                         | Organization checkout was confirmed                           |
| `organization.checkout.created`                           | Organization checkout was created                             |
| `organization.checkout.promo_code.applied`                | Promo code was applied to organization checkout               |
| `organization.checkout.promo_code.removed`                | Promo code was removed from organization checkout             |
| `organization.default_payment_method.set`                 | Default payment method set for an Organization                |
| `organization.payment_method.created`                     | Payment method created for an Organization                    |
| `organization.payment_method.deleted`                     | Payment method deleted for an Organization                    |
| `organization.payment_method.initialized`                 | Payment method setup initialized for an Organization          |
| `organization.subscription_item.canceled`                 | Organization Subscription was canceled                        |
| `organization.subscription_item.free_trial.extended`      | Free trial was extended for an Organization Subscription      |
| `organization.subscription_item.free_trial.started`       | Free trial was started for an Organization's Subscription     |
| `organization.subscription_item.price_transition.created` | Price transition was created for an Organization Subscription |
| `user.checkout.confirmed`                                 | User confirmed checkout                                       |
| `user.checkout.created`                                   | User created checkout                                         |
| `user.checkout.promo_code.applied`                        | User applied a promo code to checkout                         |
| `user.checkout.promo_code.removed`                        | User removed a promo code from checkout                       |
| `user.default_payment_method.set`                         | User set default payment method                               |
| `user.payment_method.created`                             | User created payment method                                   |
| `user.payment_method.deleted`                             | User deleted payment method                                   |
| `user.payment_method.initialized`                         | User initialized payment method setup                         |
| `user.subscription_item.canceled`                         | User canceled their Subscription                              |
| `user.subscription_item.free_trial.extended`              | Free trial was extended for a user's Subscription             |
| `user.subscription_item.free_trial.started`               | Free trial was started for a user's Subscription              |
| `user.subscription_item.price_transition.created`         | Price transition was created for a user's Subscription        |

### Email address events

| Event type               | Description                |
| ------------------------ | -------------------------- |
| `email_address.created`  | Email address was created  |
| `email_address.deleted`  | Email address was deleted  |
| `email_address.updated`  | Email address was updated  |
| `email_address.verified` | Email address was verified |

### Phone number events

| Event type              | Description               |
| ----------------------- | ------------------------- |
| `phone_number.created`  | Phone number was created  |
| `phone_number.deleted`  | Phone number was deleted  |
| `phone_number.updated`  | Phone number was updated  |
| `phone_number.verified` | Phone number was verified |

### SMS events

| Event type          | Description                                                |
| ------------------- | ---------------------------------------------------------- |
| `sms.accepted`      | SMS was accepted for delivery (delivery not yet confirmed) |
| `sms.delivered`     | SMS was delivered                                          |
| `sms.failed`        | SMS failed to send                                         |
| `sms.unconfirmed`   | SMS delivery was not confirmed                             |
| `sms.undeliverable` | SMS could not be delivered                                 |

To learn how to interpret these events, understand failure reasons, and troubleshoot delivery, see [SMS delivery events](https://clerk.com/docs/guides/dashboard/logs/sms-delivery-events.md).

### Web3 wallet events

| Event type             | Description              |
| ---------------------- | ------------------------ |
| `web3_wallet.created`  | Web3 wallet was created  |
| `web3_wallet.deleted`  | Web3 wallet was deleted  |
| `web3_wallet.verified` | Web3 wallet was verified |

### OAuth events

| Event type                                 | Description                                  |
| ------------------------------------------ | -------------------------------------------- |
| `oauth_application.dynamically_registered` | OAuth application was dynamically registered |
| `oauth_authorization.failed`               | OAuth authorization failed                   |
| `oauth_authorization.granted`              | OAuth authorization was granted              |
| `oauth_callback.failed`                    | OAuth callback failed                        |
| `oauth_consent.denied`                     | OAuth consent was denied by user             |
| `oauth_session.ended`                      | OAuth session ended                          |
| `oauth_token.created`                      | OAuth token was created                      |

### Invitation events

| Event type            | Description                      |
| --------------------- | -------------------------------- |
| `invitation.accepted` | Instance invitation was accepted |
| `invitation.created`  | Instance invitation was created  |
| `invitation.deleted`  | Instance invitation was deleted  |
| `invitation.revoked`  | Instance invitation was revoked  |

### Actor token events

| Event type            | Description             |
| --------------------- | ----------------------- |
| `actor_token.created` | Actor token was created |
| `actor_token.revoked` | Actor token was revoked |

### Sign-in token events

| Event type              | Description                        |
| ----------------------- | ---------------------------------- |
| `sign_in_token.created` | Sign-in token was created for user |
| `sign_in_token.revoked` | Sign-in token was revoked          |

### JWT service token events

| Event type                  | Description                   |
| --------------------------- | ----------------------------- |
| `jwt_service_token.created` | JWT service token was created |

### Agent Task events

| Event type           | Description            |
| -------------------- | ---------------------- |
| `agent_task.created` | Agent Task was created |
| `agent_task.revoked` | Agent Task was revoked |

### Waitlist events

| Event type               | Description                               |
| ------------------------ | ----------------------------------------- |
| `waitlist_entry.created` | Waitlist entry was created                |
| `waitlist_entry.deleted` | Waitlist entry was deleted                |
| `waitlist_entry.invited` | Invitation was sent to the waitlist entry |

---

## Sitemap

[Overview of all docs pages](https://clerk.com/docs/llms.txt)
