---
title: "POST /v2/create-user-journey"
method: POST
path: "/v2/create-user-journey"
---

# POST /v2/create-user-journey

`POST /v2/create-user-journey`

Creates a user journey within a system.

## Request body

- object
  - `systemArn` string, required — ARN identifier.
  - `name` string, required — Entity label (not part of ARN — spaces allowed).
  - `description` string — Resource description.
  - `policyArn` string — ARN identifier.
  - `clientToken` string — Idempotency token.

## Response `200`

Success

- CreateUserJourneyResponse
  - `userJourney` object, required — The created user journey.
    - `userJourneyId` string, required — The unique identifier of the user journey.
    - `name` string, required — Entity label (not part of ARN — spaces allowed).
    - `description` string — Resource description.
    - `policyArn` string — ARN identifier.
    - `createdAt` string, date-time — The timestamp when the user journey was created.
    - `updatedAt` string, date-time — The timestamp when the user journey was last updated.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ValidationException
- `483` — ConflictException
- `484` — ServiceQuotaExceededException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/resiliencehubv2.md) · [All operations](https://skmtc.net/aws/apis/resiliencehubv2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/resiliencehubv2/versions/27331d252935/schema)