> ## Documentation Index > Fetch the complete documentation index at: https://developer.findity.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an approval section > Creates a new approval section on the organization. The `type` field is mandatory and must be either DEPARTMENT or DIMENSION. Only one DEPARTMENT section is allowed per organization; DIMENSION sections require a `customDimensionDefinition.id`. The request must not include an `id`. The `organizationId` path parameter supports both the Findity id and the partner-side `externalId`. ## OpenAPI ````yaml /openapi/findity-admin-api.json post /organizations/{organizationId}/approval/sections openapi: 3.1.0 info: title: Findity Admin API description: Findity Admin API version: 1.0.0 servers: - url: https://stage-api.findity.com/api/v1/admin - url: https://api.findity.com/api/v1/admin security: - bearerAuth: [] paths: /organizations/{organizationId}/approval/sections: post: tags: - Approval summary: Create an approval section description: > Creates a new approval section on the organization. The `type` field is mandatory and must be either DEPARTMENT or DIMENSION. Only one DEPARTMENT section is allowed per organization; DIMENSION sections require a `customDimensionDefinition.id`. The request must not include an `id`. The `organizationId` path parameter supports both the Findity id and the partner-side `externalId`. operationId: adminCreateApprovalSection parameters: - $ref: '#/components/parameters/organizationIdOrExternalIdInPath' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ApprovalSectionRequest' examples: Create DEPARTMENT section: value: type: DEPARTMENT active: true sortOrder: 0 sendToUnauthorizedApprovers: false numberOfRequiredApprovals: 2 Create DIMENSION section: value: type: DIMENSION active: true sortOrder: 1 sendToUnauthorizedApprovers: false numberOfRequiredApprovals: 2 customDimensionDefinition: id: 6c2d8a0c660d45a5b3bef56c7ec1462b responses: '201': description: Approval section successfully created content: application/json: schema: $ref: '#/components/schemas/ApprovalSection' examples: Approval section created: value: id: abcdd5f401cf43549a688045b5ceef9b active: true type: DEPARTMENT numberOfRequiredApprovals: 2 sendToUnauthorizedApprovers: false sortOrder: 0 '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/400Error' examples: Id must not be provided in the request body: value: result: error code: INVALID_ID description: >- Id should not be specified when creating a new approval section Approval type is missing or invalid: value: result: error code: INVALID_APPROVAL_TYPE description: >- Type must be specified in request and it has to be of value DIMENSION or DEPARTMENT DEPARTMENT section already exists: value: result: error code: APPROVAL_SECTION_ALREADY_EXISTS description: >- Only one instance of organizational unit approval section can be present DIMENSION section is missing customDimensionDefinition.id: value: result: error code: APPROVAL_SECTION_MISSING_DIMENSION_ID description: >- Dimension setup requires to have provided the id of custom dimension Number of approvals exceeds main setup or is lower than 1: value: result: error code: INVALID_VALUE_FOR_NUMBER_OF_APPROVALS description: >- Number of approvals has to have minimum value of 1 and cannot be higher than value on default approval setup '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/404Error' examples: Organization not found: value: result: error code: ORGANIZATION_NOT_FOUND description: Organization not found No active license found for approval for organization: value: result: error code: LICENSE_APPROVAL_NOT_FOUND description: Active license for approval flow not found components: parameters: organizationIdOrExternalIdInPath: in: path name: organizationId required: true description: >- Unique identifier of the organization. String in UUID without dashes (32-character hex string) if access is done via values from Findity system otherwise, id of external system can be used schema: type: string examples: Findity unique id: value: 05b8daba9ba14a49846fe77883248cf0 External system unique id: value: a31a7372-3397-3924-ffcd-b7b4795e42eb schemas: ApprovalSectionRequest: type: object description: Request body for creating a new approval section. required: - type properties: type: type: string description: > Type of the approval section. DEPARTMENT — based on the organizational unit structure; DIMENSION — based on a custom expense dimension. Only one DEPARTMENT section is allowed per organization. enum: - DEPARTMENT - DIMENSION active: type: boolean description: Whether the section is active. Defaults to true when omitted. default: true sortOrder: type: integer description: > Zero-based position of the section within the organization's list of approval sections. When omitted, the section is appended at the end. Providing a sortOrder that is already used shifts the existing sections by 1 to make room. minimum: 0 format: int32 sendToUnauthorizedApprovers: type: boolean description: >- Whether expense reports should be sent to approvers who are not otherwise authorized on the section item. default: false numberOfRequiredApprovals: type: integer description: > Number of sequential approvals required for expense reports evaluated against this section. Must be at least 1 and cannot exceed the value set on the main approval setup. When omitted, the value inherits from the main approval setup. minimum: 1 maximum: 3 nullable: true customDimensionDefinition: type: object description: >- Custom dimension to which the section is bound. Required when type is DIMENSION; must be omitted otherwise. required: - id properties: id: allOf: - $ref: '#/components/schemas/Uuid' description: >- Findity identifier of the custom dimension definition the section is created for. ApprovalSection: type: object description: >- A single approval section — either based on organizational units (DEPARTMENT) or on a custom dimension (DIMENSION). required: - id - type - active - sortOrder properties: id: allOf: - $ref: '#/components/schemas/Uuid' readOnly: true description: Findity identifier of the approval section. active: type: boolean description: Whether the section is active for approval routing. type: type: string description: > Type of the approval section. DEPARTMENT — based on organizational unit structure; DIMENSION — based on a custom expense dimension. enum: - DEPARTMENT - DIMENSION numberOfRequiredApprovals: type: integer description: >- Number of sequential approvals required for expense reports evaluated against this section. minimum: 1 maximum: 3 nullable: true sendToUnauthorizedApprovers: type: boolean description: >- Whether expense reports are sent to approvers who are not otherwise authorized on the section item. sortOrder: type: integer description: >- Zero-based position of the section within the organization's list of approval sections. minimum: 0 format: int32 customDimensionDefinition: type: object description: >- Custom dimension the section is bound to. Present only when type is DIMENSION. nullable: true required: - id properties: id: allOf: - $ref: '#/components/schemas/Uuid' description: Findity identifier of the custom dimension definition. name: type: string description: Human-readable name of the custom dimension definition. maxLength: 255 400Error: type: object properties: result: type: string code: type: string description: type: string 404Error: type: object properties: result: type: string code: type: string description: type: string example: result: error code: ORGANIZATION_NOT_FOUND description: 'Failed to get organization for id: {orgId}' Uuid: type: string pattern: ^[0-9a-fA-F]{32}$ description: UUID without dashes (32-character hex string) securitySchemes: bearerAuth: type: http scheme: bearer ````