---
title: "POST /api/public/journeys"
method: POST
path: "/api/public/journeys"
tags: ["Journeys"]
---

# POST /api/public/journeys

`POST /api/public/journeys`

Create a customer journey. The journey is created without steps; add and order its steps in the Coach UI, then activate it. Trainees are only enrolled once the journey is active.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `title` string, required — Journey name shown to the coach.
  - `description` string
  - `autoAssign` boolean — Automatically enroll trainees that match the filters below.
  - `autoAssignPriority` integer — Lower runs first when several journeys match.
  - `anchorType` 'escort_start' | 'enrollment' — Whether day counting starts from the escort start date or from the moment the trainee is enrolled.
  - `filterLabels` string[] — Only auto-enroll trainees with these label ids.
  - `filterEscortTypes` string[]
  - `filterGender` string[]
  - `durationWeeks` integer
  - `matchByDuration` boolean

## Response `201`

Created

- object — Created
  - `data` object
  - `warnings` object[] — Non-fatal problems with follow-up writes. The resource was created, but each listed field was not applied.
    - `field` string
    - `message` string

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `429` — Default Response
- `500` — Default Response

---

[API](https://skmtc.dev/coach-platform/apis/coach-platform-api.md) · [All operations](https://skmtc.dev/coach-platform/apis/coach-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coach-platform/coach-platform-api/revisions/3d18b514ae8c/schema)