# contractorOps.payouts.send

Send an approved payout through Wise (quote, recipient, transfer, fund from balance). Requires an administrator in the dashboard, the confirmed total and currency, expectedRevision, and idempotencyKey. Refused while an hour in the payout has a correction waiting, and while an hour is still inside the wait after approval unless overrideReason says why (audited). Retries never create a second transfer. Not available to API keys or MCP clients.

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

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

Not available over MCP: Moves money.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `id` | string (ID) | Yes | The record's ID. |
| `expectedRevision` | integer | Yes | The record's current revision, from the last time you read it. If someone changed the record since, the request is refused with a conflict so you can reload and check before trying again. at most 9007199254740991; greater than 0. |
| `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. |
| `confirmTotalMinor` | string | Yes | An amount in cents (the currency's smallest unit), written as a whole-number string such as "1250" for $12.50. Matches ^\d{1,15}$. |
| `confirmCurrency` | string | Yes | Three-letter currency code, such as CAD. |
| `overrideReason` | string |  | 3–500 characters. |

## Example request

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

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