---
title: "POST /api/v1/onboarding/complete"
method: POST
path: "/api/v1/onboarding/complete"
tags: ["onboarding"]
---

# POST /api/v1/onboarding/complete

`POST /api/v1/onboarding/complete`

## Request

- Base URL: `https://api.clerkchat.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clerkchat.co/api/v1/onboarding/complete`
- Auth: none required

## Request body

- object
  - `flowId` 'initial-workspace', required
  - `flowVersion` union, required
    - number
    - 'Infinity' | '-Infinity' | 'NaN'
  - `answers` object, required
    - `referral` 'Google search' | 'X (formerly Twitter)' | 'LinkedIn' | 'YouTube' | 'Instagram' | 'TikTok' | 'A friend or colleague' | 'AI recommendation' | 'Other', required
    - `companyType` union, required
      - object
        - `value` 'B2B SaaS' | 'Service Agencies' | 'Fintech & Payments' | 'Insurance' | 'Law Firms' | 'Marketplaces' | 'Real Estate' | 'Clinics' | 'Industrial Equipment & Manufacturing' | 'Ecommerce & DTC' | 'Consumer Electronics & Appliances' | 'Hotels & Resorts' | 'Travel & Tour Operators' | 'Accounting & Corporate Secretarial' | 'Immigration Consultancies' | 'Online Education' | 'Fitness Chains & Franchises' | 'Restaurants', required
      - object
        - `value` 'Other', required
        - `detail` string, required
    - `companySize` 'Startup (1-9)' | 'Small business (10-49)' | 'Mid-market (50-499)' | 'Enterprise (500+)', required
    - `trainingSource` union, required
      - object
        - `type` 'website', required
        - `websiteUrl` string, required
      - object
        - `type` 'text', required
        - `title` string, required
        - `body` string, required
      - object
        - `type` 'qa', required
        - `title` string, required
        - `question` string, required
        - `answer` string, required
      - object
        - `type` 'file', required
        - `title` string, required
        - `fileName` string, required
        - `fileKind` 'pdf' | 'txt' | 'md' | 'csv' | 'tsv' | 'json' | 'xls' | 'xlsx', required
        - `fileContentType` string, required
        - `fileSizeBytes` union, required
          - number
          - 'Infinity' | '-Infinity' | 'NaN'
        - `fileBase64` string, required
    - `personality` object, required
      - `role` 'Customer support' | 'Sales agent' | 'Shopping assistant', required
      - `instructions` string, required

## Response `200`

Success

- union
  - object
    - `status` 'incomplete', required
  - object
    - `status` 'not_required', required
    - `organizationId` string, required
  - object
    - `status` 'completed', required
    - `flowId` string, required
    - `flowVersion` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `organizationId` string, required
    - `completedAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `agentId` string, nullable
    - `organizationSlug` string, nullable

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `503`: PersistenceUnavailable

---

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