Request Reimbursement Approval

requestReimbursement

Submit a manager approval request to reimburse a user by moving funds between spend accounts on the same account. When approved, Fluz processes the reimbursement.

Scopes

Action	Scope
Create request	`REQUEST_REIMBURSEMENT`
List requests	`LIST_APPROVALS`
Approve or decline	`MANAGE_APPROVALS`

Webhook Identifiers

Field	Value
`approvalType`	`PAYOUT`
`approvalCode`	`500401`

Webhook events: APPROVAL_CREATE, APPROVAL_APPROVE, APPROVAL_DECLINE, and APPROVAL_HANDLER_ERROR on execution failure.

Create a Request

RequestReimbursementInput

Field	Type	Required	Description
`amount`	Float	Yes	Reimbursement amount. Must be greater than zero
`sourceUserCashBalanceId`	UUID	Yes	Spend account to withdraw from (typically a company or shared balance)
`destinationUserCashBalanceId`	UUID	Yes	Spend account to credit (typically the requester's balance)
`memo`	String	No	Transaction memo
`categoryId`	UUID	No	Transaction category ID

Source and destination must be different spend accounts.

Sample Mutation

mutation {
  requestReimbursement(
    input: {
      amount: 75.00
      sourceUserCashBalanceId: "6d1b4b19-deef-42f5-80d7-ec34804ce090"
      destinationUserCashBalanceId: "bb584e49-d030-4a6e-a5a9-1c34368cbaed"
      memo: "Client dinner reimbursement"
    }
  ) {
    success
    messageId
    error {
      code
      message
    }
  }
}

Sample Response

{
  "data": {
    "requestReimbursement": {
      "success": true,
      "messageId": "1234567890"
    }
  }
}

Approve a Request

Call approveApprovalRequest with the approvalId. Requires MANAGE_APPROVALS.

mutation {
  approveApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}

On approval, Fluz processes the reimbursement transfer.

Decline a Request

Call declineApprovalRequest with the approvalId. Requires MANAGE_APPROVALS.

mutation {
  declineApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}

No reimbursement is processed when a request is declined.