---
title: "Changes to Update beneficial owner"
method: POST
path: "/beneficial-owners/{id}"
---

# Changes to Update beneficial owner

`POST /beneficial-owners/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 33 revisions.

- **2025-11-19** `e44b6a6d5724` — 3 warning, 7 info
- **2025-07-01** `8a20e7000645` — 1 breaking, 1 info
- **2025-06-06** `231d0268586b` — 1 breaking, 2 info
- **2025-05-23** `4c8b16e05918` — 1 breaking

## Changes

- **2025-11-19** `e44b6a6d5724` — 3 warning, 7 info
  - added the new `document` enum value to the `verificationStatus` response property for the response status `200`
  - added the new `incomplete` enum value to the `verificationStatus` response property for the response status `200`
  - added the new `verified` enum value to the `verificationStatus` response property for the response status `200`
  - the response property `_links` became required for the status `200`
  - the response property `address` became required for the status `200`
  - the response property `created` became required for the status `200`
  - the response property `firstName` became required for the status `200`
  - the response property `id` became required for the status `200`
  - the response property `lastName` became required for the status `200`
  - the response property `verificationStatus` became required for the status `200`
- **2025-07-01** `8a20e7000645` — 1 breaking, 1 info
  - removed `#/components/schemas/BeneficialOwnerWithSsn, #/components/schemas/BeneficialOwnerWithPassport` from the request body `oneOf` list
  - added `#/components/schemas/CreateUSBeneficialOwner, #/components/schemas/CreateInternationalBeneficialOwner` to the request body `oneOf` list
- **2025-06-06** `231d0268586b` — 1 breaking, 2 info
  - request body became required
  - the response property `code` became required for the status `400`
  - the response property `message` became required for the status `400`
- **2025-05-23** `4c8b16e05918` — 1 breaking
  - added the new required `header` request parameter `Accept`

---

[Operation](https://skmtc.dev/dwolla/apis/dwolla-api/docs/beneficial-owners/:id/post.md) · [API](https://skmtc.dev/dwolla/apis/dwolla-api.md) · [Page](https://skmtc.dev/dwolla/apis/dwolla-api/changes/beneficial-owners/:id/post)