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
object
Occurs whenever a business account is created.
object
Occurs whenever the account’s own details change, such as its name.
object
Occurs whenever a member is added to a business account. Carries the member’s role.
object
Occurs whenever a member’s role changes. Carries the new role.
object
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.object
Occurs whenever ownership moves to another member. Carries both the previous and the new owner.
object
Occurs whenever a member gains a key share on one of the account’s wallets, making them a signer.
object
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.
object
Occurs whenever a wallet comes under the account’s control.
object
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.
object
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.object
Occurs whenever a custom role is defined. Carries the role name and
inherits, the built-in role it takes its permissions from.object
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.