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.
curl --request POST \
--url https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "DEPARTMENT",
"active": true,
"sortOrder": 0,
"sendToUnauthorizedApprovers": false,
"numberOfRequiredApprovals": 2
}
'{
"id": "abcdd5f401cf43549a688045b5ceef9b",
"active": true,
"type": "DEPARTMENT",
"numberOfRequiredApprovals": 2,
"sendToUnauthorizedApprovers": false,
"sortOrder": 0
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
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
Body
Request body for creating a new approval section.
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.
DEPARTMENT, DIMENSION Whether the section is active. Defaults to true when omitted.
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.
x >= 0Whether expense reports should be sent to approvers who are not otherwise authorized on the section item.
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.
1 <= x <= 3Custom dimension to which the section is bound. Required when type is DIMENSION; must be omitted otherwise.
Hide child attributes
Hide child attributes
Findity identifier of the custom dimension definition the section is created for.
^[0-9a-fA-F]{32}$Response
Approval section successfully created
A single approval section — either based on organizational units (DEPARTMENT) or on a custom dimension (DIMENSION).
Findity identifier of the approval section.
^[0-9a-fA-F]{32}$Whether the section is active for approval routing.
Type of the approval section. DEPARTMENT — based on organizational unit structure; DIMENSION — based on a custom expense dimension.
DEPARTMENT, DIMENSION Zero-based position of the section within the organization's list of approval sections.
x >= 0Number of sequential approvals required for expense reports evaluated against this section.
1 <= x <= 3Whether expense reports are sent to approvers who are not otherwise authorized on the section item.
Custom dimension the section is bound to. Present only when type is DIMENSION.
curl --request POST \
--url https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "DEPARTMENT",
"active": true,
"sortOrder": 0,
"sendToUnauthorizedApprovers": false,
"numberOfRequiredApprovals": 2
}
'{
"id": "abcdd5f401cf43549a688045b5ceef9b",
"active": true,
"type": "DEPARTMENT",
"numberOfRequiredApprovals": 2,
"sendToUnauthorizedApprovers": false,
"sortOrder": 0
}