> ## Documentation Index
> Fetch the complete documentation index at: https://www.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Business account action webhooks

> Events emitted when a business account changes: membership, roles, signers, wallets, and governance.

Business account events fire under the `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](/docs/business-accounts/webhooks/proposals).

For the shared event envelope, endpoint setup, retries, and signature verification, see [Setting up webhooks](/docs/platform/dashboard/webhooks/setup) and [Event delivery & best practices](/docs/platform/dashboard/webhooks/delivery-best-practices). The current list of event types is always available from the [event types endpoint](/docs/api-reference/events/get-event-types).

Browse [all webhook events](/docs/platform/dashboard/webhooks/event-types) for the full listing across Dynamic products.

## Account and membership

<ParamField body="businessAccount.created" type="object">
  Occurs whenever a business account is created.
</ParamField>

<ParamField body="businessAccount.updated" type="object">
  Occurs whenever the account's own details change, such as its name.
</ParamField>

<ParamField body="businessAccount.member.added" type="object">
  Occurs whenever a member is added to a business account. Carries the member's role.
</ParamField>

<ParamField body="businessAccount.member.roleChanged" type="object">
  Occurs whenever a member's role changes. Carries the new role.
</ParamField>

<ParamField body="businessAccount.member.removed" type="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.
</ParamField>

<ParamField body="businessAccount.ownership.transferred" type="object">
  Occurs whenever ownership moves to another member. Carries both the previous and the new owner.
</ParamField>

<ParamField body="businessAccount.signer.added" type="object">
  Occurs whenever a member gains a key share on one of the account's wallets, making them a signer.
</ParamField>

<ParamField body="businessAccount.signer.revoked" type="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.
</ParamField>

<ParamField body="businessAccount.wallet.linked" type="object">
  Occurs whenever a wallet comes under the account's control.
</ParamField>

<ParamField body="businessAccount.wallet.unlinked" type="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.
</ParamField>

## 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 document `version` rather than the rules or roles themselves. Read the governance section through the API to get the new values.

<ParamField body="businessAccount.governance.updated" type="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.
</ParamField>

<ParamField body="businessAccount.role.defined" type="object">
  Occurs whenever a custom role is defined. Carries the role name and `inherits`, the built-in role it takes its permissions from.
</ParamField>

<ParamField body="businessAccount.role.deleted" type="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.
</ParamField>

## Related events

An approved change sends **two** events: the ordinary account event on this page and a proposal event. See [Proposal webhooks](/docs/business-accounts/webhooks/proposals) for the approval lifecycle.