# Create an onboarding link for a merchant

Creates a new onboarding link for a merchant. Important: Creating a new link will automatically expire all previous onboarding links for the same merchant.

Endpoint: POST /v1/onboarding_links
Version: v1
Security: account-secret

## Request fields (application/json):

  - `merchant_id` (string, required)

  - `return_url` (string)
    URL to redirect after onboarding completion
    Example: "https://dashboard.example.com?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

  - `type` (string, required)
    Enum: "account_onboarding"

## Response 201 fields (application/json):

  - `url` (string, required)
    The URL of the onboarding link with token
    Example: "https://dashboard.example.com?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

  - `id` (string, required)
    The ID of the onboarding link

  - `expires_at` (string, required)
    The expiration date of the onboarding link

  - `merchant_id` (string, required)
    The merchant ID associated with this onboarding link