Create (activate) main approval setup

Activates the approval workflow for an organization by creating the main approval setup. The request must not include an id field. If an approval setup is already active for the organization, use PUT /organizations/{organizationId}/approval/{approvalId} to update it instead. 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
integer
required
1 to 3

Number of sequential approvals an expense report must receive before it can be submitted. Only applicable when requiresApproval is true. Must be between 1 and 3.

defaultApprover
object
required

The person designated as the default approver when no other approver is assigned to a submitter. Required when requiresApproval is true. Identify the person by providing either their Findity id or their externalId. In case that id is provided, externalId will be disregarded.

Responses

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