> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.thepennyinc.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.thepennyinc.com/_mcp/server.

# business_entity.updated

POST 

Sent when a `business_entity.updated` event occurs.

Reference: https://docs.thepennyinc.com/api-reference/penny-banking/webhook-payloads/business-entity/business-entity-updated-webhook

## Request

### Payload

- `event_id` (string, required) — Penny's unique identifier for this notification event.
- `business_id` (string, required) — The business the event belongs to. When the event originated from a different business, this contains the originating business.
- `type` ("business_entity.updated", required) — The notification event type. This identifies the specific occurrence represented by the event and determines how its data should be interpreted.
- `category` ("object", required) — The category of the event payload. This groups related notification event types and describes the general kind of data contained in ``data``.
- `schema_version` ("1.0", required) — The version of the JSON notification event schema used to encode this webhook payload.
- `event_time` (datetime, required) — The date and time Penny generated the notification event.
- `occurrence_time` (datetime, required) — The date and time the underlying occurrence represented by this notification event took place.
- `data` (WebhooksBusinessEntityUpdatedWebhookPayloadContentApplicationJsonSchemaData, required) — A notification about a domain object being created, updated, or deleted.

## Types

### WebhooksBusinessEntityUpdatedWebhookPayloadContentApplicationJsonSchemaData

A notification about a domain object being created, updated, or deleted.

- `operation` (enum, required) — The change that produced this event: 'created', 'updated', or 'deleted'.
  - Allowed values: `created`, `updated`, `deleted`
- `subject` (ObjectReferenceResponse, required) — The object this event concerns.
- `category` ("object", optional, default: object) — Identifies this payload as an object change.
- `object` (BusinessEntityWebhookPayload, optional) — The event payload delivered to a subscriber's webhook when a business entity is created or changed.
- `previous_attributes` (map from string to any, optional, nullable) — The object's attributes before this change, if included.

### ObjectReferenceResponse

A pointer to the object this event concerns.

- `object_type` (string, required) — The kind of object this event concerns.
- `object_id` (string, required) — The unique identifier of the object this event concerns.
- `version` (integer, optional, nullable) — The object's version at the time of this event, if known.
- `stage` (integer, optional, nullable) — The object's lifecycle stage at the time of this event, if applicable.

### BusinessEntityWebhookPayload

The event payload delivered to a subscriber's webhook when a business entity is created or changed.

- `business_entity_id` (string, required) — Penny's unique identifier for this business entity.
- `business_id` (string, required) — The business this entity belongs to.
- `version` (integer, required) — A number that increases each time this business entity's details change. Use it to confirm you are looking at the latest information.
- `version_time` (datetime, required) — The date and time this business entity's details were last changed.
- `status` (enum, required) — The business entity's current lifecycle status.
  - Allowed values: `pending`, `active`, `deactivated`, `suspended`, `closed`
- `active` (boolean, required) — Whether this business entity is currently active.
- `closed` (boolean, required) — Whether this business entity has been closed.
- `legal_name` (string, required) — The business entity's full registered legal name.
- `dba_name` (string, required) — The name the business entity trades under, if different from its legal name.
- `registration_date` (date, required) — The date this business entity was legally registered.
- `address` (AddressResponse, required) — The business entity's registered physical address. On the client API, shown as masked placeholders unless the request is for a single business entity retrieved directly.
- `kyb_details` (KYBDetailsResponse, required) — The status of this business entity's identity verification.
- `website` (string, optional, nullable) — The business entity's website address, if it has one.
- `phone` (string, optional, nullable) — The business entity's contact phone number, if provided. On the client API, shown as a masked placeholder unless the request is for a single business entity retrieved directly.
- `email` (string, optional, nullable) — The business entity's primary contact email address, if provided. On the client API, shown as a masked placeholder unless the request is for a single business entity retrieved directly.
- `registration_number` (string, optional, nullable) — The business entity's official government registration number, if it has one on file. On the client API, shown as a masked placeholder unless the request is for a single business entity retrieved directly.

### AddressResponse

External API representation of a physical address. Country is normalized to ISO 3166-1 alpha-2. State/province is normalized to its subdivision code where applicable.

- `line_1` (string, required) — Primary address line.
- `city` (string, required) — City or locality.
- `zip_code` (string, required) — Postal or ZIP code.
- `country` (string, required) — Country in ISO 3166-1 alpha-2 format.
- `line_2` (string, optional, nullable) — Secondary address line.
- `state_or_province` (string, optional, nullable) — State or province code (if applicable).

### KYBDetailsResponse

The status of a business entity's identity verification (Know Your Business, or KYB) check, and the outcome once a decision has been made.

- `status` (enum, required) — Where this business entity is in the verification process: 'not_submitted' (verification has not started), 'pending' or 'in_progress' (under review), 'approved', or 'declined'.
  - Allowed values: `not_submitted`, `pending`, `in_progress`, `approved`, `declined`
- `rejection_reason` (string, optional, nullable) — Why verification was rejected. Absent unless status is 'declined'.