# contractorOps.payouts.preview

Prepare a final Wise payment preview for an approved payout, including its exact named funding profile and balance, recipient, fees, exchange rate, recipient amount and maximum debit. This can create or reuse the Wise recipient and create a quote, but does not create a transfer or move money. Only an administrator in Oatmilk in a browser can prepare it; API keys, MCP clients and Ask AI get INTERACTIVE_ADMIN_REQUIRED with a link to review it there. Read contractorOps.payouts.get or contractorOps.pay.status for existing source identity and readiness.

`POST /api/v1/accounting/contractorOps.payouts.preview`

Permissions: `accounting:read`, `accounting:write`, `accounting:admin` · Roles: admin · Idempotency key required · Reaches outside Oatmilk (email or a provider)

Not available over MCP: Preparing the final send preview may create a Wise recipient and quote. An administrator reviews this in the browser; agents read existing funding identity and readiness.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `id` | string (ID) | Yes | The record's ID. |
| `idempotencyKey` | string | Yes | Any unique text you generate once per intended change, so a retried request only happens once. Send it as the Idempotency-Key header instead if you prefer; if you send both they must match. 8–200 characters. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/contractorOps.payouts.preview \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
}'
```

Reference page: https://app.getoatmilk.com/docs/api/contractorOps.payouts.preview