businessAccount.* namespace. Business accounts group members, signers, and wallets under one account; these events cover changes to the account itself and to who can act on it. Changes that need approvals also emit the proposal events described in Proposal webhooks.
For the shared event envelope, endpoint setup, retries, and signature verification, see Setting up webhooks and Event delivery & best practices. The current list of event types is always available from the event types endpoint.
Browse all webhook events for the full listing across Dynamic products.
Account and membership
Occurs whenever a member is removed. Removing a member also revokes their key shares, so this is followed by one
businessAccount.signer.revoked event for each wallet they signed on.Occurs whenever ownership moves to another member. Carries both the previous and the new owner.
Occurs whenever a member gains a key share on one of the account’s wallets, making them a signer.
Occurs whenever a signer’s key share on a wallet is revoked. Also sent for each signer severed by a member removal or a wallet unlink.
Occurs whenever a wallet leaves the account. Every signer on that wallet loses their key share, so this is accompanied by a
businessAccount.signer.revoked event for each.Governance and roles
An account’s governance section holds the approval rules, and its roles decide what a member can do. Both live in the account’s signed document, so these three events carry the resulting documentversion rather than the rules or roles themselves. Read the governance section through the API to get the new values.
Occurs whenever the approval rules change. Carries
governedActions, the list of actions that now have a rule, and not the rules themselves (a rule names the users and roles that can approve). Read the governance section through the API to get the new rules.Occurs whenever a custom role is defined. Carries the role name and
inherits, the built-in role it takes its permissions from.Occurs whenever a custom role is deleted. A role cannot be deleted while a member still holds it, so no member loses access as a result.