> 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.

# Update an invoice group

> Learn how to update an existing invoice group configuration by using the Settings API.

Learn how to update an existing invoice group configuration by using the Settings API.

Use this operation to change how subscription charges and order line items (OLIs) are grouped into invoices and credit memos as part of Configurable Invoice Grouping.

To update an invoice group, the ID or number of the specific invoice group is required as a path parameter. See the following request and a sample of a 200 response.

HTTP request:

`PUT {api_url}/settings/invoice-groups/{id | number}`

Request body:

```json
{
  "name": "My Global Group",
  "meta": {
    "subscriptionGroup": [
      {
        "objectType": "Subscription",
        "field": "TransactionType__c"
      },
      {
        "objectType": "Subscription",
        "field": "SoldToContactId"
      },
      {
        "objectType": "RatePlanCharge",
        "field": "TransactionType__c"
      },
      {
        "objectType": "RatePlanCharge",
        "field": "ChargeType"
      }
    ],
    "orderLineItemGroup": [
      {
        "objectType": "OrderLineItem",
        "field": "TransactionType__c"
      },
      {
        "objectType": "OrderLineItem",
        "field": "SoldTo"
      }
    ]
  }
}
```

The **meta** object is updated atomically as a whole.

> **Note**
>
> Partial updates are not supported; any fields omitted from the request are removed from the invoice group configuration.

Response body:

A successful call returns 200 OK with the updated invoice group configuration, including the system-generated identifiers:

```json
{
  "id": "2c92c0f977123456017712f9e6a00001",
  "number": "IG-00000001",
  "name": "My Global Group",
  "meta": {
    "subscriptionGroup": [
      {
        "objectType": "Subscription",
        "field": "TransactionType__c"
      },
      {
        "objectType": "Subscription",
        "field": "SoldToContactId"
      },
      {
        "objectType": "RatePlanCharge",
        "field": "TransactionType__c"
      },
      {
        "objectType": "RatePlanCharge",
        "field": "ChargeType"
      }
    ],
    "orderLineItemGroup": [
      {
        "objectType": "OrderLineItem",
        "field": "TransactionType__c"
      },
      {
        "objectType": "OrderLineItem",
        "field": "SoldTo"
      }
    ]
  }
}
```