---
title: "Create division"
method: POST
path: "/corporate/v2/divisions"
tags: ["Divisions"]
---

# Create division

`POST /corporate/v2/divisions`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/corporate/v2/divisions`
- Auth: HTTP bearer

Creates a division by level and hierarchy ID. To use the holidays defined in an administrative division, specify its ID in `administrative_division_id` to link your division.

This endpoint generates a [Corporate division created](https://developers.pismo.io/events/docs/corporate-division-creation-2) event.

## Request body

- CreateDivisionRequestV2: Create division request body
  - `division_code` string, required: Code used to identify your division within the organization. Division code should only contain letters, numbers, and hyphens. This is a client-provided ID and can be changed.
  - `hierarchy_id` string, uuid, required: Hierarchy ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
  - `level_id` string, uuid, required: Level ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
  - `name` string: Division name
  - `parent_code` string: Division code that can be set as the parent of the division being created. The parent must be at a level with a lower index than the division being created. It must comply with the rule `^[a-zA-Z0-9-]+$`.
  - `description` string, nullable: Division description
  - `timezone` string: Division timezone in timezone database format.<br> This value is used in the calculations for holidays, weekends, and daily balances. If a timezone is not specified, the division inherits the timezone from its parent division. If the parent division also lacks a specified timezone, Pismo defaults to using UTC. To clear this field, specify an empty string.
  - `program_ids` integer[]: List of allowed program IDs. The programs must belong to the organization. This list is used for validation during the [Create transaction banking account](ref:post-account) process. You can retrieve the organization programs using the [List programs](ref:programs-1) endpoint. If no program IDs are specified, this division inherits the `program_ids` list from the parent division, if it exists.
  - `administrative_division_id` integer: Administrative division ID. Specifying an administrative division ID in this field links your division to it. This is useful when you want to use the holidays defined in that administrative division.<br> **NOTE**: `administrative_division_id` points to [holiday calendar](ref:post-add-holiday-to-calendar). Administrative division is deprecated and replaced by holiday calendar, and both continue to use the same underlying data structure for backward compatibility. The administrative division ID is functionally equivalent to `holiday_calendar_id` and refers to the calendar that defines holidays and working days. For more information, refer to [Add holiday](ref:post-add-holiday-to-calendar).
  - `schema` SchemaCreateTransactionBankingAccount: Valid JSON Schema as defined at https://json-schema.org/specification.html. This schema validates the JSON custom fields used in the [Create transaction banking account](ref:post-account) process. If this field is not set, the division inherits its schema from the parent division, if one exists. The example below is shown in YAML for readability; the API requires JSON.

## Response `201`

Created

- CreateDivisionsResponseV2: Create division response body
  - `division_id` string, uuid, required: The Pismo platform generates the division ID when you use the [Create division](ref:post-division-v2) endpoint. This ID is immutable and cannot be changed.
  - `division_code` string, required: Code used to identify your division within the organization. Division code should only contain letters, numbers, and hyphens. This is a client-provided ID and can be changed.
  - `parent_code` string: Division code that can be set as the parent of the division being created. The parent must be at a level with a lower index than the division being created. It must comply with the rule `^[a-zA-Z0-9-]+$`.
  - `level_id` string, uuid, required: Level ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
  - `description` string, nullable: Division description
  - `name` string: Division name
  - `administrative_division_id` integer: Administrative division ID. Specifying an administrative division ID in this field links your division to it. This is useful when you want to use the holidays defined in that administrative division.<br> **NOTE**: `administrative_division_id` points to [holiday calendar](ref:post-add-holiday-to-calendar). Administrative division is deprecated and replaced by holiday calendar, and both continue to use the same underlying data structure for backward compatibility. The administrative division ID is functionally equivalent to `holiday_calendar_id` and refers to the calendar that defines holidays and working days. For more information, refer to [Add holiday](ref:post-add-holiday-to-calendar).

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `403`: The request has been lost
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/banking-transaction-banking.md) - [All operations](https://skmtc.dev/pismo/apis/banking-transaction-banking/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-transaction-banking/revisions/1334306c9303?raw)