---
title: "Connect Onboard"
method: POST
path: "/api/v1/playbooks/my/connect/onboard"
tags: ["playbooks"]
---

# Connect Onboard

`POST /api/v1/playbooks/my/connect/onboard`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/playbooks/my/connect/onboard`
- Auth: none declared

Start (or resume) Stripe Connect Express onboarding for the caller.

Creates a Stripe Express account on first call (persisting its `acct_…` id
so a retry reuses it rather than orphaning a second account), then mints a
single-use Account Link the frontend redirects the seller to. The seller
completes KYB on Stripe's hosted flow; we learn the outcome via the
`/connect/status` poll and the `account.updated` webhook.

Fail-safe (CLAUDE.md rule #7): 503 "Stripe not configured" when
STRIPE_SECRET_KEY is unset — allowlisted in the Sentry before_send filter.

## Response `200`

Successful Response

- ConnectOnboardResponse: Body for POST /playbooks/my/connect/onboard.
  - `onboarding_url` string, required

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)