Webhook events

Webhooks notify your backend when something changes in Dynamic, such as a user signing in, a wallet being created, or a payment reaching settlement. Browse the events below by product and follow each section’s reference link for payloads and additional behavior. To start receiving events, follow Setting up webhooks. For signature verification, retries, and duplicate handling, see Event delivery and best practices.

Find an event

I want to track…	Browse
Users, sign-ins, sessions, and linked credentials	Authentication
Wallet creation, signing, backup, and recovery	Embedded wallets
Confirmed wallet transactions and monitoring registration	On-chain activity
An agent’s delegated wallet access	Agents
Business membership, wallets, roles, and approvals	Business accounts
Policy blocks and address screening decisions	Policy and screening
Payment execution, settlement, and risk changes	Fireblocks Flow
Dashboard administration and environment changes	Developer Dashboard and environment

This listing brings together the events documented in Dynamic’s product references. The event types endpoint provides the current catalog. Your integration should tolerate new event types as they are added. The deprecated alias is documented at the end.

Authentication

See Auth webhooks for payloads and details.

Event	When it fires
`user.created`	A user is created.
`user.updated`	A user is updated.
`user.deleted`	A user is deleted.
`user.merged`	User accounts are merged.
`visit.created`	A visit is created.
`user.session.created`	A user session is created.
`user.session.revoked`	A user session is revoked.
`user.signin.failed`	A sign-in attempt fails.
`user.social.linked`	A user links a social account.
`user.social.unlinked`	A user unlinks a social account.
`user.passkeyRecovery.started`	Passkey recovery begins.
`user.passkeyRecovery.completed`	Passkey recovery completes.

Embedded wallets

See Embedded wallet webhooks for payloads and details.

Event	When it fires
`wallet.created`	A Dynamic embedded wallet is created.
`wallet.linked`	A wallet is linked to a user.
`wallet.unlinked`	A wallet is unlinked from a user.
`wallet.exported`	A Dynamic embedded wallet is exported.
`wallet.transferred`	A wallet moves between user accounts.
`wallet.signature`	An embedded wallet signature completes.
`wallet.keyShares.backedUp`	Wallet key shares are backed up.
`wallet.keyShares.backedUpToExternal`	A user backs up their key share to external storage.
`wallet.keyShares.recovered`	Wallet key shares are recovered.
`wallet.keyShares.refreshed`	Wallet key shares are refreshed.
`wallet.keyShares.reshared`	Wallet key shares are redistributed across a new set of parties.
`wallet.offlineRecovery.created`	An offline recovery kit is created.

On-chain activity

See On-chain events for supported networks, monitoring requirements, and payloads.

Event	When it fires
`wallet.activity`	A confirmed transaction involves a user’s wallet.
`wallet.activity.registered`	A wallet is newly registered for on-chain monitoring in an environment with tracking enabled.

Agents

See Agent webhooks for payloads and details.

Event	When it fires
`wallet.delegation.created`	An agent or service is granted delegated signing access.
`wallet.delegation.signature`	A delegated signer completes a wallet signature.
`wallet.delegation.revoked`	An agent or service’s delegated signing access is revoked.

Business accounts

See Business account webhooks for payloads and approval behavior.

Accounts, members, and wallets

Event	When it fires
`businessAccount.created`	A business account is created.
`businessAccount.member.added`	A member joins the account.
`businessAccount.member.roleChanged`	A member’s role changes.
`businessAccount.member.removed`	A member is removed from the account.
`businessAccount.ownership.transferred`	Ownership transfers to another member.
`businessAccount.signer.added`	A member becomes a signer on an account wallet.
`businessAccount.signer.revoked`	A signer’s access to an account wallet is revoked.
`businessAccount.wallet.linked`	A wallet comes under the account’s control.
`businessAccount.wallet.unlinked`	A wallet leaves the account.

Governance and approvals

Event	When it fires
`businessAccount.governance.updated`	The account’s approval rules change.
`businessAccount.role.defined`	A custom role is defined.
`businessAccount.role.deleted`	A custom role is deleted.
`businessAccount.proposal.created`	A proposal opens for a change that requires approval.
`businessAccount.proposal.approved`	An approver records an approval.
`businessAccount.proposal.approvalWithdrawn`	An approver withdraws an earlier approval.
`businessAccount.proposal.vetoed`	A proposal is rejected with a final veto.
`businessAccount.proposal.executed`	The proposal’s requirements are met and its change takes effect.

An approval event does not mean the proposed change has taken effect. Use businessAccount.proposal.executed to track execution, and subscribe to the corresponding account events to track the changes themselves.

Policy and screening

See Policy and screening webhooks for payloads and verdict behavior.

Event	When it fires
`waas.policy.violation`	A configured policy rule blocks a transaction.
`wallet.sanctions.blocked`	A sanctions decision blocks a wallet address.
`wallet.addressScreening.blocked`	Your address screening rules or address lists block a wallet address.
`wallet.addressScreening.alerted`	Your address screening policy returns an alert for a wallet address.

Fireblocks Flow

See Flow webhooks for state transitions, payloads, and payment reconciliation.

Event	When it fires
`flow.execution.updated`	A flow’s execution state changes.
`flow.settlement.updated`	A flow’s settlement state changes.
`flow.risk.updated`	A flow’s risk assessment state changes.
`user.exchangeTransfer.success`	An exchange transfer is successfully initiated.
`user.exchangeTransfer.failed`	An exchange transfer fails.

Execution, settlement, and risk progress independently. Use the completed settlement state to identify a completed payment; a successful exchange-transfer initiation does not establish that funds have arrived.

Developer Dashboard and environment

These events track administration of your Dynamic organization, projects, users, and webhook configuration. Organization members are the team members you invite to your Dynamic organization; business account members are covered separately under Business accounts. Events with the admin.* prefix describe administrative actions. The environment.updated event also covers changes made through the SDK API. See Admin and environment events for payloads and the shared event envelope.

Policies and address screening

Event	When it fires
`admin.waas.policy.created`	An admin creates a wallet policy.
`admin.waas.policy.updated`	An admin updates a wallet policy.
`admin.waas.policy.rule.created`	An admin creates a policy rule.
`admin.waas.policy.rule.updated`	An admin updates a policy rule.
`admin.waas.policy.rule.deleted`	An admin deletes a policy rule.
`admin.addressScreening.byok.created`	An admin adds a customer-supplied screening key.
`admin.addressScreening.byok.rotated`	An admin rotates a screening key.
`admin.addressScreening.byok.disabled`	An admin disables a screening key.
`admin.addressScreening.policy.created`	An admin creates an address screening policy.
`admin.addressScreening.policy.updated`	An admin changes screening rules or address exceptions.
`admin.addressScreening.policy.deleted`	An admin deletes an address screening policy.

Domains and environments

Event	When it fires
`admin.environment.domain.created`	An admin creates a custom domain.
`admin.environment.domain.updated`	An admin updates a custom domain.
`admin.environment.domain.deleted`	An admin deletes a custom domain.
`admin.environment.apiToken.created`	An admin creates an API token.
`admin.environment.apiToken.deleted`	An admin deletes an API token.
`admin.environment.settings.updated`	An admin updates environment settings.
`admin.environment.mfa.deleted`	An admin deletes a user’s MFA device.
`admin.environment.sessions.revoked`	An admin revokes all user sessions in an environment.
`environment.updated`	An environment changes, including through the SDK API.

Organization members and settings

These events track your Dynamic organization, its billing settings, and the team members who have access to it.

Event	When it fires
`admin.organization.created`	An admin creates an organization.
`admin.organization.updated`	An admin updates an organization.
`admin.organization.billing.updated`	An admin updates organization billing settings.
`admin.organization.member.invited`	An admin invites an organization member.
`admin.organization.member.joined`	A member joins an organization.
`admin.organization.member.removed`	An admin removes an organization member.

Projects

Event	When it fires
`admin.project.created`	An admin creates a project.
`admin.project.updated`	An admin updates a project.
`admin.project.deleted`	An admin deletes a project.

User administration

These events track an admin creating, updating, or deleting users and revoking their sessions. Business account membership changes use businessAccount.member.* events.

Event	When it fires
`admin.user.created`	An admin creates a user.
`admin.user.updated`	An admin updates a user.
`admin.user.deleted`	An admin deletes a user.
`admin.user.session.revoked`	An admin revokes a user session.

Webhook configuration

These events track changes to the webhook endpoints you configure for your environment.

Event	When it fires
`admin.webhook.created`	An admin creates a webhook.
`admin.webhook.updated`	An admin updates a webhook.
`admin.webhook.deleted`	An admin deletes a webhook.

Security settings

Event	When it fires
`admin.security.accessControl.created`	An admin creates security access control settings.
`admin.security.cookieDomain.created`	An admin creates a cookie domain.
`admin.security.cors.created`	An admin creates a CORS origin.
`admin.security.cors.updated`	An admin updates a CORS origin.
`admin.security.cors.deleted`	An admin deletes a CORS origin.
`admin.security.ipSettings.updated`	An admin updates IP settings.
`admin.security.jwtSettings.updated`	An admin updates JWT settings.

Deprecated alias

sanctions.wallet.blocked is a deprecated alias of wallet.sanctions.blocked. Existing subscriptions continue to receive it, but new subscriptions should use wallet.sanctions.blocked. See Policy and screening webhooks.

Learn

Build with

Find an event

Authentication

Embedded wallets

On-chain activity

Agents

Business accounts

Accounts, members, and wallets

Governance and approvals

Policy and screening

Fireblocks Flow

Developer Dashboard and environment

Policies and address screening

Domains and environments

Organization members and settings

Projects

User administration

Webhook configuration

Security settings

Deprecated alias

​Find an event

​Authentication

​Embedded wallets

​On-chain activity

​Agents

​Business accounts

​Accounts, members, and wallets

​Governance and approvals

​Policy and screening

​Fireblocks Flow

​Developer Dashboard and environment

​Policies and address screening

​Domains and environments

​Organization members and settings

​Projects

​User administration

​Webhook configuration

​Security settings

​Deprecated alias

Find an event

Authentication

Embedded wallets

On-chain activity

Agents

Business accounts

Accounts, members, and wallets

Governance and approvals

Policy and screening

Fireblocks Flow

Developer Dashboard and environment

Policies and address screening

Domains and environments

Organization members and settings

Projects

User administration

Webhook configuration

Security settings

Deprecated alias