---
updatedAt: 2026-06-24T15:01:46.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# Create administrative division (deprecated)

**DEPRECATED**. Call [Create holiday calendar](ref:post-create-holiday-calendar) instead. 

This endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.

Create an administrative division. 

Administrative divisions are used to divide an organization's territory into separate areas. An organization covering Great Britian for example, might want to have separate divisions for England, Scotland, and Ireland. Each of these countries may have different holidays and need to be administered in different ways. 

There is a [Create administrative division](ref:post-v2-admin-division) V2 endpoint designed for greater flexibility in defining non-business days to accommodate specific business requirements. For details about the differences, refer to [Platform setup - Holidays and administrative divisions](doc:platform-setup-holidays#endpoints-for-transaction-banking).


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Platform setup - Divisions",
    "description": "Use administrative divisions to align organization territory with business needs",
    "version": "v1.0",
    "contact": {
      "name": "Pismo Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing"
    }
  ],
  "security": [
    {
      "S2SAuthentication": []
    }
  ],
  "tags": [
    {
      "name": "Administrative divisions (deprecated)",
      "description": "View and manage administrative divisions."
    }
  ],
  "components": {
    "schemas": {
      "AdminDivisionExternalID": {
        "type": "string",
        "description": "Client-supplied external ID. It must comply with the rule `^[a-zA-Z0-9-]+$`.",
        "example": "8675309"
      },
      "AdminDivisionExternalIdReference": {
        "type": "string",
        "description": "External ID reference. Must comply with the rule `^[a-zA-Z0-9-]+$`.",
        "example": "CRM-software-ID"
      },
      "AdminDivisionID": {
        "type": "integer",
        "description": "Admininistrative division ID",
        "example": 84849
      },
      "AdminDivisionName": {
        "type": "string",
        "description": "Administrative division name",
        "example": "Scotland"
      },
      "AdminDivisionParentID": {
        "type": "integer",
        "description": "Parent ID"
      },
      "AdminDivisionType": {
        "type": "string",
        "description": "Admin division type",
        "enum": [
          "City",
          "State",
          "Country"
        ],
        "example": "State"
      },
      "handler.HTTPError": {
        "description": "Code and error message.",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error code"
          },
          "message": {
            "type": "string",
            "description": "Error message"
          }
        }
      },
      "presenter.v1CreateAdministrativeDivisionRequest": {
        "type": "object",
        "description": "Data to create an administrative division",
        "required": [
          "name",
          "type"
        ],
        "properties": {
          "name": {
            "$ref": "#/components/schemas/AdminDivisionName"
          },
          "type": {
            "$ref": "#/components/schemas/AdminDivisionType"
          },
          "parent_id": {
            "$ref": "#/components/schemas/AdminDivisionParentID"
          },
          "external_id": {
            "$ref": "#/components/schemas/AdminDivisionExternalID"
          },
          "external_id_reference": {
            "$ref": "#/components/schemas/AdminDivisionExternalIdReference"
          }
        }
      },
      "presenter.v1CreateAdministrativeDivisionResponse": {
        "description": "Administrative division creation response",
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/AdminDivisionID"
          },
          "external_id": {
            "$ref": "#/components/schemas/AdminDivisionExternalID"
          },
          "name": {
            "$ref": "#/components/schemas/AdminDivisionName"
          },
          "parent_id": {
            "$ref": "#/components/schemas/AdminDivisionParentID"
          },
          "type": {
            "$ref": "#/components/schemas/AdminDivisionType"
          }
        }
      }
    },
    "responses": {
      "401UnauthorizedError": {
        "description": "Access token is missing or invalid",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            }
          }
        }
      },
      "500InternalServerError": {
        "description": "Internal server error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "S2SAuthentication": {
        "type": "http",
        "scheme": "bearer",
        "description": "All requests must be previously authenticated with an account token."
      }
    },
    "examples": {
      "MissingTenantResponse": {
        "value": {
          "code": "400",
          "message": "Missing x-tenant header"
        }
      },
      "InvalidParamsResponse": {
        "value": {
          "code": "400",
          "message": "Invalid {parameter_name} parameter value"
        }
      },
      "NotFoundResponse": {
        "value": {
          "code": "404",
          "message": "{target_name} not found"
        }
      }
    }
  },
  "paths": {
    "/divisions-core/v1/administrative-division": {
      "post": {
        "summary": "Create administrative division (deprecated)",
        "description": "**DEPRECATED**. Call [Create holiday calendar](https://developers.pismo.io/pismo-docs/reference/post-create-holiday-calendar) instead. \n\nThis endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.\n\nCreate an administrative division. \n\nAdministrative divisions are used to divide an organization's territory into separate areas. An organization covering Great Britian for example, might want to have separate divisions for England, Scotland, and Ireland. Each of these countries may have different holidays and need to be administered in different ways. \n\nThere is a [Create administrative division](https://developers.pismo.io/pismo-docs/reference/post-v2-admin-division) V2 endpoint designed for greater flexibility in defining non-business days to accommodate specific business requirements. For details about the differences, refer to [Platform setup - Holidays and administrative divisions](https://developers.pismo.io/pismo-docs/docs/platform-setup-holidays#endpoints-for-transaction-banking).\n",
        "operationId": "post-v1-admin-division",
        "deprecated": true,
        "tags": [
          "Administrative divisions (deprecated)"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/presenter.v1CreateAdministrativeDivisionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/presenter.v1CreateAdministrativeDivisionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/handler.HTTPError"
                },
                "examples": {
                  "response-missing-tenant": {
                    "$ref": "#/components/examples/MissingTenantResponse"
                  },
                  "invalid-params-response": {
                    "$ref": "#/components/examples/InvalidParamsResponse"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401UnauthorizedError"
          },
          "404": {
            "description": "Not found error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/handler.HTTPError"
                },
                "examples": {
                  "not-found-response": {
                    "$ref": "#/components/examples/NotFoundResponse"
                  }
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    }
  }
}
```