> 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-object-reference/amendment/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Amendment

> The Amendment object holds the changes that you want to make to the relevant Subscription object, including its RatePlan, RatePlanCharge, and RatePlanChargeTier.

The Amendment object holds the changes that you want to make to the relevant Subscription object, including its RatePlan, RatePlanCharge, and RatePlanChargeTier.

Amendments change subscriptions. When a customer needs to make a change to a subscription, you make that change through an amendment. Common changes include the following:

* Change the terms and conditions of a contract.
* Add a product to, or remove of product from, a subscription.
* Update an existing product, such as changing the quantity.
* Renew a subscription on the autorenewal date or before.
* Cancel a subscription, or transfer to another owner (can be also be done directly on a subscription without an amendment)
* Suspend an active subscription. (This feature is in Limited Availability.)
* Resume a suspended subscription. (This feature is in Limited Availability.)

## Supported calls

You can use this object with the following calls:

* amend()
* create()
* query()
* update()
* delete()

  > **Note**
  >
  > Invoiced amendments cannot usually be deleted. One exception to this rule is auto-renew amendments. You can delete the last auto-renew amendment even if an invoice has been generated.

## Walkthroughs and use cases

Here are some common ways to use this object:

* Add a product to the subscription - set `Type` to `NewProduct`
* Update information about a product's rate plan charge - set `Type` to `UpdateProduct`
* Remove a product or part of a product from a subscription - set `Type` to `RemoveProduct`
* Change the terms and conditions of the subscription - set `Type` to `TermsAndConditions`
* Change the owner of the subscription set `Type` to `OwnerTransfer`
* Renew a subscription - set `Type` to `Renewal`
* Cancel a subscription - set `Type` to `Cancellation`
* Suspend a subscription (This feature is in Limited Availability.) set `Type` to `SuspendSubscription`
* Resume a subscription (This feature is in Limited Availability.) set `Type` to `ResumeSubscription`

> The Amendment object holds the changes that you want to make to the relevant Subscription object, including its RatePlan, RatePlanCharge, and RatePlanChargeTier.

## Docs

- [Field descriptions of Amendment](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-object-reference/amendment/field-descriptions.md): This reference provides the description of the fields of the Amendment object.
- [Additional field details of Amendment](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-object-reference/amendment/additional-field-details.md): Additional details of the fields of the Amendment object.
- [Remove a Product (Amendment)](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-object-reference/amendment/remove-a-product-amendment.md): Use the RemoveProduct amendment to remove products from subscriptions by using the amend() or create() API calls, depending on your Zuora API or WSDL version.
- [Remove a Product from a Subscription (API versions 24.0 and earlier)](https://zuora.ferndocs.com/docs/platform/integration/apis/soap-api/soap-api-object-reference/amendment/remove-a-product-from-a-subscription-api-versions-240-and-earlier.md): Use SOAP API calls to create an amendment, add a rate plan, and update the amendment to remove a product from a subscription.