---
title: "Update an accounting period"
method: PUT
path: "/v1/accounting-periods/{ap-id}"
tags: ["Accounting Periods"]
---

# Update an accounting period

`PUT /v1/accounting-periods/{ap-id}`

Updates an accounting period.

Prerequisites
-------------

* You must have Zuora Finance enabled on your tenant.

* You must have the Create Accounting Period user permission. See [Finance Roles](https://docs.zuora.com?resourceId=platform-finance-roles).

Limitations
-----------

* You can update the start date of only the earliest accounting period on your tenant. You cannot update the start date of later periods.

* If you update the earliest accounting period, the start date must be equal to or earlier than the date of the earliest transaction on the tenant.

* Start and end dates of accounting periods must be contiguous. For example, if one accounting period ends on January 31, the next period must start on February 1.

* If you have the Revenue Recognition Package and have enabled the "Monthly recognition over time" revenue recognition model, the accounting period start date and end date must be on the first day and last day of the month, respectively. Note that the start and end dates do not necessarily have to be in the same month.

* You cannot update the start date or end date of an accounting period if:
  * Any revenue has been distributed into the period.
  * The period has any active journal entries.

## Path parameters

- `ap-id` 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

- PUTAccountingPeriodType — Container for custom fields of an Accounting Period object.
  - `endDate` string, date — The end date of the accounting period in yyyy-mm-dd format, for example, "2016-02-19".
  - `fiscalYear` integer — Fiscal year of the accounting period in yyyy format, for example, "2016".
  - `fiscalQuarter` integer — Fiscal quarter of the accounting period. One number between 1 and 4.
  - `name` string — Name of the accounting period. Accounting period name must be unique. Maximum of 100 characters.
  - `notes` string — Notes about the accounting period. Maximum of 255 characters.
  - `startDate` string, date — The start date of the accounting period in yyyy-mm-dd format, for example, "2016-02-19".

## 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)