# newAccount on PUT /v1/orders/{} is deprecated

Zuora API deprecated PUT /v1/orders/{id}, body parameter newAccount without giving a shutdown date yet.

Zuora API deprecated the newAccount body parameter on PUT /v1/orders/{id} on March 15, 2024, without a shutdown date. Calls that continue to pass the parameter will fail. The change applies directly to the request body of the update order operation.

## What to use instead

Create the account first using POST /v1/accounts and reference it with existingAccountNumber when updating the order.

- API: Zuora API (rest.zuora.com)
- Kind: Parameter removal
- Announced: March 15, 2024
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `PUT /v1/orders/{id}`, `body parameter newAccount`
- Source: [Announcement](https://developer.zuora.com/docs/get-started/changelogs/v1-api-changelog)
- Verified: November 6, 2026, against Zuora API's own pages
- Page: https://www.okapi.bot/providers/zuora-api/breaking-changes/newaccount-on-put-v1-orders-is-deprecated/

## Zuora API's words

> In the request body of the "Update an order" operation, deprecated the newAccount field.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent