> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```graphql theme={null}
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

```json theme={null}
{
  "data": {
    "requestReimbursement": {
      "success": true,
      "messageId": "1234567890"
    }
  }
}
```

## Approve a Request

Call `approveApprovalRequest` with the `approvalId`. Requires `MANAGE_APPROVALS`.

```graphql theme={null}
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`.

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

No reimbursement is processed when a request is declined.