API Reference

Create an approval section

post
https://stage-api.findity.com/api/v1/admin/organizations//approval/sections

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.

Path Params
string
required

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 Params

Request body for creating a new approval section.

string
enum
required

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.

Allowed:
boolean
Defaults to true

Whether the section is active. Defaults to true when omitted.

int32
≥ 0

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.

boolean
Defaults to false

Whether expense reports should be sent to approvers who are not otherwise authorized on the section item.

integer | null
1 to 3

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.

customDimensionDefinition
object

Custom dimension to which the section is bound. Required when type is DIMENSION; must be omitted otherwise.

Responses

Updated about 5 hours ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 5 hours ago

Did this page help you?