# 🔗 Generate onboarding link for a client

Generate an onboarding link for a specific client.

The onboarding experience can be customized with:
- include_kyc: Add a Know Your Customer verification step
- include_signature: Require electronic signature of the PDP mandate

The generated link is time-limited and client-specific.

Endpoint: POST /clients/onboarding-link
Version: 1.0.0
Security: APIKeyHeader

## Request fields (application/json):

  - `include_kyc` (boolean)
    Include KYC (Know Your Customer) step in the onboarding experience

  - `include_signature` (boolean)
    Require electronic signature of the PDP mandate during onboarding

  - `callback_url` (any)
    URL to redirect to after onboarding completion
    Example: "https://your-app.com/onboarding-complete"

## Response 201 fields (application/json):

  - `onboarding_url` (string, required)
    Generated onboarding URL

  - `link_id` (string, required)
    Unique identifier for this onboarding link

  - `expires_at` (string, required)
    When this onboarding link expires

  - `includes_kyc` (boolean, required)
    Whether KYC step is included

  - `includes_signature` (boolean, required)
    Whether electronic signature is required

  - `callback_url` (any)
    Callback URL for redirection after completion

## Response 401 fields (application/json):

  - `error` (string, required)

  - `code` (integer, required)

  - `trace_id` (string, required)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)


## Response 404 fields