---
title: "Attach charges to an invoice schedule"
method: PUT
path: "/v1/invoice-schedules/{scheduleKey}/attach"
tags: ["Invoice Schedules"]
---

# Attach charges to an invoice schedule

`PUT /v1/invoice-schedules/{scheduleKey}/attach`

Attaches charges to an invoice schedule. The invoice schedules you want to attach charges to must be in Fully Processed or Partially Processed status. 
You can attach charges only if they were previously detached from the same invoice schedule. Invoice schedules will automatically bill re-attached charges in the upcoming planned invoice schedule items.

## Path parameters

- `scheduleKey` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Request body

- AttachInvoiceScheduleRequest
  - `specificSubscriptions` object[] — A list of charge numbers to be attached to the invoice schedule. Each item in this array represents a specific subscription associated with the invoice schedule. Use the `chargeNumbers` field to specify all the charges you want to attach for each subscription.
    - `chargeNumbers` string — A list of charge numbers in the subscription to be attached to the invoice schedule. If you want to attach all charges, you must specify all of the charge numbers in this field.
    - `orderKey` string — The unique ID or number of the order associated with the invoice schedule.
    - `subscriptionKey` string — The unique number of the subscription contained in the order associated with the invoice schedule.

## Response `200`

OK

- CommonResponse
  - `processId` string — The ID of the process that handles the operation.
  - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`.
    - `code` string — The error code of response.
    - `message` string — The detail information of the error response
  - `requestId` string, uuid — Unique identifier of the request.
  - `success` boolean — Indicates whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)