---
title: "Create an accounting period"
method: POST
path: "/v1/accounting-periods"
tags: ["Accounting Periods"]
---

# Create an accounting period

`POST /v1/accounting-periods`

Creates an accounting period.
Prerequisites
-------------
* You must have Zuora Finance enabled on your tenant.
* You must have the Create Accounting Period user permission.

Limitations
-----------
* When creating the first accounting period on your tenant, 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.

## Headers

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

## Request body

- POSTAccountingPeriodType — Container for custom fields of an Accounting Period object.
  - `endDate` string, date, required — The end date of the accounting period in yyyy-mm-dd format, for example, "2016-02-19".
  - `fiscalYear` integer, required — 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, required — 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.
  - `organizationLabels` object[] — The organization that the accounting period belongs to. For each item in the array, either the `organizationId` or the `organizationName` field is required. This field is only required when you have already turned on Multi-Org feature.
    - `organizationId` string — The organization ID.
    - `organizationName` string — The organization name.
  - `startDate` string, date, required — The start date of the accounting period in yyyy-mm-dd format, for example, "2016-02-19".

## Response `200`

OK

- POSTAccountingPeriodResponseType
  - `id` string — ID of the newly-created accounting period.
  - `success` boolean — Returns `true` if the request was processed successfully.

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