> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.dynamic.xyz/docs/business-accounts/webhooks/proposals.md).

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

Browse [all webhook events](https://docs.dynamic.xyz/docs/platform/console/webhooks/event-types.md) for the full listing across Dynamic products.

## Account and membership

**businessAccount.created** `object`

Occurs whenever a business account is created.

**businessAccount.updated** `object`

Occurs whenever the account's own details change, such as its name.

**businessAccount.member.added** `object`

Occurs whenever a member is added to a business account. Carries the member's role.

**businessAccount.member.roleChanged** `object`

Occurs whenever a member's role changes. Carries the new role.

**businessAccount.member.removed** `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.

**businessAccount.ownership.transferred** `object`

Occurs whenever ownership moves to another member. Carries both the previous and the new owner.

**businessAccount.signer.added** `object`

Occurs whenever a member gains a key share on one of the account's wallets, making them a signer.

**businessAccount.signer.revoked** `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.

**businessAccount.wallet.linked** `object`

Occurs whenever a wallet comes under the account's control.

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

**businessAccount.governance.updated** `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.

**businessAccount.role.defined** `object`

Occurs whenever a custom role is defined. Carries the role name and `inherits`, the built-in role it takes its permissions from.

**businessAccount.role.deleted** `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.

## Related events

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.