Payroll
Run a payroll
POST
/payroll/runsScope
payroll:writeAuth Bearer keyIdempotentCreates and starts a payroll run for an existing payroll. The run reserves funding from your balance and dispatches payouts on the same rails the dashboard uses, so an Idempotency-Key is required: retrying with the same key returns the original run instead of paying staff twice.
Headers
Idempotency-KeystringrequiredRetrying with the same key and payload replays the original response.
Responses
202Payroll run started
Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X POST "https://business.boundlesspay.com/api/public/v1/payroll/runs" \ -H "Authorization: Bearer $BOUNDLESS_API_KEY" \ -H "Idempotency-Key: $(uuidgen)"