---
title: "Start an onboarding session"
method: POST
path: "/api/onboarding/conversational/start"
tags: ["Conversational onboarding"]
---

# Start an onboarding session

`POST /api/onboarding/conversational/start`

## Request

- Base URL: `https://api.chipprofessionals.com`
- URL: `https://api.chipprofessionals.com/api/onboarding/conversational/start`
- Auth: HTTP bearer

## Request body

- object
  - `role_id` integer, required: Existing Consumer or Professional role ID
  - `force` boolean

## Response `200`

Existing session returned

- SuccessResponse: Standard success response format
  - `success` boolean
  - `message` string
  - `data` unknown

## Other responses

- `201`: Session created
- `401`: Unauthenticated
- `422`: Invalid role or request body

---

[API](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation.md) - [All operations](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/revisions/05e58f424c25?raw)