> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/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.

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

## Docs

- [Request: AmendRequest](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendrequest-objects-and-containers.md): Use this reference to learn the AmendRequest objects and containers.
- [AmendOptions for amend()](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendrequest-objects-and-containers/amendoptions.md): Use this reference to learn the AmendOptions container and its fields.
- [Additional field details](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendrequest-objects-and-containers/amendoptions/additional-details.md): Provides additional field details about InvoiceProcessingOptions and ProcessPayments.
- [PreviewOptions](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendrequest-objects-and-containers/previewoptions.md): Use the PreviewOptions container to preview an amendment before committing its changes to a subscription.
- [ExternalPaymentOptions](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendrequest-objects-and-containers/externalpaymentoptions-fields.md): Use the ExternalPaymentOptions container to create or change a subscription and mark its invoice as already paid.
- [Response: AmendResult](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amendresult-fields.md): Use this reference to learn the AmendResult wrapper and its fields.
- [Example: amend() call](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-calls/amend/amend-call-example.md): This reference provides an example of using the amend() call.