---
title: "Start Payout Onboarding"
method: POST
path: "/v1/worker/me/payouts/connect"
tags: ["payouts"]
---

# Start Payout Onboarding

`POST /v1/worker/me/payouts/connect`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/worker/me/payouts/connect`
- Auth: none declared

Returns {url, account_id}. Worker visits the URL to onboard their bank
account via Stripe Connect Express. Once they return, we'll know they've
connected (Stripe webhook + GET /payouts updates the flag).

If the worker already has a stripe_account_id (e.g. an earlier attempt
didn't finish onboarding), reuse that account and just issue a fresh
AccountLink -- AccountLinks expire after a few minutes. Creating a new
Account on every call would silently orphan whichever ones the worker
didn't finish, and this row would end up pointing at the wrong one.

## Headers

- `authorization` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mundane/apis/mundane-api.md) · [All operations](https://skmtc.dev/mundane/apis/mundane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mundane/apis/mundane-api/revisions/f1cba6e69834?raw)