Create and execute a one-off payment (async)

Creates an ad-hoc payroll run and immediately begins execution. Use for bonuses, reimbursements, or irregular payments.

When an ad-hoc run completes, the next scheduled payroll run is automatically skipped (can be rolled back via audit log).

Requires payroll:draft + payroll:execute scopes. Requires Idempotency-Key header.

Side effects: Sets skipNextScheduled=true on org. Creates ADHOC_PAYMENT_CREATED audit entry.

Authorization

apiKey

AuthorizationBearer <token>

API key: Authorization: Bearer mpk_live_<key>

In: header

Header Parameters

Idempotency-Key*string

UUID v4. Required on all write operations. Prevents duplicate execution on retry.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

label?string

Name for the ad-hoc run

items*array<>

Items1 <= items

Response Body

curl -X POST "https://motivation-money.vercel.app/api/v1/adhoc-payments" \  -H "Idempotency-Key: 7f3c4d2a-8b1e-4f6a-9c2d-1a5b8e3f7d4c" \  -H "Content-Type: application/json" \  -d '{    "label": "Q1 2026 Bonuses",    "items": [      {        "employee_id": "usr_emp456",        "amount_usd_cents": 200000,        "note": "Q1 performance bonus"      },      {        "employee_id": "usr_emp789",        "amount_usd_cents": 150000,        "note": "Referral bonus"      }    ]  }'

Empty