---
title: "Create a companion from onboarding funnel answers"
method: POST
path: "/v1/models/from-onboarding"
tags: ["Models"]
---

# Create a companion from onboarding funnel answers

`POST /v1/models/from-onboarding`

Creates a private companion from the marketing-funnel quiz answers, reusing the static paywall avatar instead of generating one. Charges no coins and is not gated by the model limit. Idempotent per user: a repeat call (same or new sessionId) returns the existing onboarding companion.

## Request body

- CreateModelFromOnboardingRequestBodyDto
  - `sessionId` string, required — Acquisition session id of the funnel run, stored on the created model for tracing. Idempotency itself is per user: any repeat call returns the existing onboarding companion.
  - `gender` 'male' | 'female', required — Companion gender, from the funnel `welcome` answer.
  - `age` string — Raw funnel `age` bucket token (e.g. "18-24").
  - `ethnicity` string — Raw funnel `ethnicity` token (e.g. "european").
  - `bodyShape` string — Raw funnel `body_shape` token.
  - `hairColor` string — Raw funnel `hair_color` token (female grid).
  - `requestId` string — Optional request id for analytics correlation.

## Response `201`

Companion creation enqueued

- CreateModelResponseBodyDto
  - `modelId` string, required — The model ID
  - `balance` number, required — The balance after the model creation

## Other responses

- `422` — Validation failed

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)