> This page is for Docs.

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

# amend()

> Use the amend() call to change a subscription, such as upgrading the subscription.

Use the amend() call to change a subscription, such as upgrading the subscription.

## Usage

* Supported objects: [Amendment](/docs/platform/integration/apis/soap-api/soap-api-object-reference/amendment)
* Version availability: WSDL 28.0+
* Asynchronous process: no

## Limits

Objects per call - The number of amendments supported in a single `amend` call are:

* For WSDL versions 69+: Up to 10 amendments
* For WSDL versions 42.0 through 68: Up to 3 amendments
* For WSDL versions 29.0 through 41.0: Only 1 amendment

## Errors

If one of your `Amendment` objects fails in a single `amend()` call, then the entire call fails.

## Fields

The following fields are always required for this call:

`Amendment.Type`

* `Amendment.Name`
* `Amendment.SubscriptionId`

## Syntax and Arguments

![Amend call diagram for syntax and arguments](/_fern-img/4bf2a1cd5cabfa5645160794ce053a4a6d5ee7bc72a5ee3cd7b8aadc97f17f27.webp)

The amend() call uses the following items:

* Call wrappers

  * `AmendRequest`
  * `AmendResult`
* Containers

  * `AmendOptions`
  * `PreviewOptions`
  * `ExternalPaymentOptions`
* Object

  * `Amendment`

## Call wrappers

Every amend() request requires an [AmendRequest](/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendrequest-objects-and-containers) wrapper. Every amend() call responds with an [AmendResult](/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendresult-fields) wrapper.