approvalUserSetup resource type

Represents the approval setup for a user in Business Central.

Note

For information about enabling APIs for Business Central, see Enabling the APIs for Dynamics 365 Business Central.

Methods

MethodReturn typeDescription
GET approvalUserSetupapprovalUserSetupGets an approval user setup object.

Properties

PropertyTypeDescription
idGUIDThe unique ID of the approval user setup. Read-only.
userIdstringThe ID of the user.
userFullNamestringThe full name of the user.
salesPersonPurchaserstringThe salesperson or purchaser code associated with the user.
approverIdstringThe ID of the user's approver.
salesAmountApprovalLimitintegerThe maximum sales amount that the user can approve.
unlimitedSalesApprovalbooleanIndicates whether the user can approve sales amounts without a limit.
purchaseAmountApprovalLimitintegerThe maximum purchase amount that the user can approve.
unlimitedPurchaseApprovalbooleanIndicates whether the user can approve purchase amounts without a limit.
requestApprovalAmountLimitintegerThe maximum request amount that the user can approve.
unlimitedRequestApprovalAmountbooleanIndicates whether the user can approve request amounts without a limit.
substitutestringThe ID of the user who acts as the substitute approver.
emailstringThe email address of the user.
phoneNumberstringThe phone number of the user.
approvalAdminbooleanIndicates whether the user is an approval administrator.
lastModifiedDateTimedatetimeThe date and time when the approval user setup was last modified. Read-only.

JSON representation

Here's a JSON representation of the approvalUserSetup resource.

{
    "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "userId": "SARA",
    "userFullName": "Sara Davis",
    "salesPersonPurchaser": "SD",
    "approverId": "ADMIN",
    "salesAmountApprovalLimit": 10000,
    "unlimitedSalesApproval": false,
    "purchaseAmountApprovalLimit": 15000,
    "unlimitedPurchaseApproval": false,
    "requestApprovalAmountLimit": 5000,
    "unlimitedRequestApprovalAmount": false,
    "substitute": "ALEX",
    "email": "sara@contoso.com",
    "phoneNumber": "555-0100",
    "approvalAdmin": false,
    "lastModifiedDateTime": "2026-08-04T11:00:00Z"
}

GET approvalUserSetup