Create division

post

https://sandbox.pismolabs.io/corporate/v2/divisions

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Create level division request body

Create division request body

division_code

string

required

length ≤ 36

Code used to identify your division within the organization. Division code should only contain letters, numbers, and hyphens.

hierarchy_id

uuid

required

length ≤ 36

Hierarchy ID generated by the Create hierarchy endpoint.

level_id

uuid

required

≤ 36

Level ID generated by the Create hierarchy endpoint.

name

string

≤ 40

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

Division description

timezone

string

Division timezone in timezone database format.
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

array of int32s

≤ 100

List of allowed program IDs. The programs must belong to the organization. This list is used for validation during the Create transaction banking account process. You can retrieve the organization programs using the List programs endpoint. If no program IDs are specified, this division inherits the program_ids list from the parent division, if it exists.

program_ids

administrative_division_id

int64

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.

schema

object

Valid JSON schema as specified in https://json-schema.org/specification.html. Used to validate the JSON of custom fields in the Create transaction banking account process. If this field is not set, the division inherits its schema from the parent division, if it exists.

Responses

401

Access token is missing or invalid

403

The request has been lost

Create division

Changelog

Support

Pismo is here to help

201Created

400Bad request

404Not Found

409Conflict

500Internal Server Error