---
title: "createJourneyV2"
method: POST
path: "/v2/journey/configuration"
tags: ["Journeys V2"]
---

# createJourneyV2

`POST /v2/journey/configuration`

Create a Journey

## Query parameters

- `skipAutomation` string, Yn

## Request body

- JourneyCreationRequestV2
  - `journeyId` string
  - `brandId` string
  - `name` string, required
  - `steps` object[], required
    - `showStepName` boolean, nullable
    - `title` string, nullable
    - `subTitle` string, nullable
    - `showStepSubtitle` boolean, nullable
    - `showStepper` boolean, nullable
    - `showStepperLabels` boolean, nullable
    - `stepperType` 'numbers' | 'progress bar'
    - `hideNextButton` boolean, nullable
    - `name` string, required
    - `stepId` string
    - `schema` unknown, required
    - `uischema` unknown, required
    - `maxWidth` 'small' | 'medium' | 'large' | 'extra large'
  - `design` object
    - `logoUrl` string, nullable
    - `theme` object
    - `designTokens` object
  - `rules` object[]
    - `type` 'inject' | 'injectWithKey', required
    - `sourceType` 'journey' | 'step' | 'block', required
    - `source` string, required
    - `target` string, required
  - `logics` object[]
    - `autoGeneratedId` string
    - `conditions` string[], required
    - `actions` string[], required
  - `logicsV4` object
  - `contextSchema` object[]
    - `id` string, uuid — Unique identifier for the context schema item
    - `type` string, required — Type of the parameter. It could be either an entity slug, or a text
    - `paramKey` string, required — Expected key to be received in the context
    - `isRequired` boolean — Indicates if a value is expected to be provided
    - `shouldLoadEntity` boolean — If type is not text, we can instruct the journey to fetch the entity id we receive as value
    - `description` string, nullable — Human-readable note describing the parameter's purpose. Free text; may contain newlines.
  - `journey_type` string — Journey Template
  - `protected` boolean — If true, journey is displayed in read-only mode
  - `protectedEditable` string[] — Whitelist of paths that remain editable when the journey is protected. Supports wildcard patterns (e.g. steps/*/blocks/**).
  - `settings` object
    - `embedOptions` object
      - `mode` 'full-screen' | 'inline'
      - `lang` 'de' | 'en' | 'fr'
      - `width` string
      - `topBar` boolean
      - `scrollToTop` boolean
      - `button` object
        - `text` string, nullable
        - `align` 'left' | 'center' | 'right'
    - `safeModeAutomation` boolean
    - `designId` string
    - `entityId` string, nullable
    - `mappingsAutomationId` string
    - `templateId` string, nullable
    - `targetedCustomer` string
    - `description` string, nullable
    - `publicToken` string, nullable
    - `runtimeEntities` string[]
    - `filePurposes` string[]
    - `entityTags` string[]
    - `addressSuggestionsFileUrl` string, nullable — @deprecated Use addressSuggestionsFileId instead
    - `addressSuggestionsFileId` string, nullable
    - `addressSuggestionsCountryCode` string, nullable — Country code for address format (e.g. DE, AT, CH, LU)
    - `addressSuggestionsEnableAutoComplete` boolean — Whether address auto-complete is enabled
    - `addressSuggestionsSource` string[] — Sources for address auto-complete (e.g. deutschePostService, customAddressesFile)
    - `addressSuggestionsEnableFreeText` boolean — Whether free text input is allowed when auto-complete is on
    - `useNewDesign` boolean — This property is deprecated and will be removed in a future version
    - `thirdPartyCookies` boolean — If false, third-party cookies are disabled to comply with GDPR regulations without asking for consent.
    - `accessMode` 'PUBLIC' | 'PRIVATE'
    - `enableDarkMode` boolean — If true, the journey shows an icon to toggle dark mode
    - `useAustrianLabels` boolean — If true, some journey input labels are in Austrian format
    - `isActive` boolean
    - `savingProgress` object
      - `mode` 'auto' | 'local' | 'remote' | 'none'
      - `supportedRevision` number
  - `validationRules` ValidationRuleRef — References to validation rules organized by blocks and fields. Maps block IDs to either rule IDs (for block-level rules) or rule references (for field-level rules).
  - `_manifest` string[] — Manifest/Blueprint ID used to create/update the entity

## Response `201`

Success

- JourneyCreationRequestV2
  - `journeyId` string
  - `brandId` string
  - `name` string, required
  - `steps` object[], required
    - `showStepName` boolean, nullable
    - `title` string, nullable
    - `subTitle` string, nullable
    - `showStepSubtitle` boolean, nullable
    - `showStepper` boolean, nullable
    - `showStepperLabels` boolean, nullable
    - `stepperType` 'numbers' | 'progress bar'
    - `hideNextButton` boolean, nullable
    - `name` string, required
    - `stepId` string
    - `schema` unknown, required
    - `uischema` unknown, required
    - `maxWidth` 'small' | 'medium' | 'large' | 'extra large'
  - `design` object
    - `logoUrl` string, nullable
    - `theme` object
    - `designTokens` object
  - `rules` object[]
    - `type` 'inject' | 'injectWithKey', required
    - `sourceType` 'journey' | 'step' | 'block', required
    - `source` string, required
    - `target` string, required
  - `logics` object[]
    - `autoGeneratedId` string
    - `conditions` string[], required
    - `actions` string[], required
  - `logicsV4` object
  - `contextSchema` object[]
    - `id` string, uuid — Unique identifier for the context schema item
    - `type` string, required — Type of the parameter. It could be either an entity slug, or a text
    - `paramKey` string, required — Expected key to be received in the context
    - `isRequired` boolean — Indicates if a value is expected to be provided
    - `shouldLoadEntity` boolean — If type is not text, we can instruct the journey to fetch the entity id we receive as value
    - `description` string, nullable — Human-readable note describing the parameter's purpose. Free text; may contain newlines.
  - `journey_type` string — Journey Template
  - `protected` boolean — If true, journey is displayed in read-only mode
  - `protectedEditable` string[] — Whitelist of paths that remain editable when the journey is protected. Supports wildcard patterns (e.g. steps/*/blocks/**).
  - `settings` object
    - `embedOptions` object
      - `mode` 'full-screen' | 'inline'
      - `lang` 'de' | 'en' | 'fr'
      - `width` string
      - `topBar` boolean
      - `scrollToTop` boolean
      - `button` object
        - `text` string, nullable
        - `align` 'left' | 'center' | 'right'
    - `safeModeAutomation` boolean
    - `designId` string
    - `entityId` string, nullable
    - `mappingsAutomationId` string
    - `templateId` string, nullable
    - `targetedCustomer` string
    - `description` string, nullable
    - `publicToken` string, nullable
    - `runtimeEntities` string[]
    - `filePurposes` string[]
    - `entityTags` string[]
    - `addressSuggestionsFileUrl` string, nullable — @deprecated Use addressSuggestionsFileId instead
    - `addressSuggestionsFileId` string, nullable
    - `addressSuggestionsCountryCode` string, nullable — Country code for address format (e.g. DE, AT, CH, LU)
    - `addressSuggestionsEnableAutoComplete` boolean — Whether address auto-complete is enabled
    - `addressSuggestionsSource` string[] — Sources for address auto-complete (e.g. deutschePostService, customAddressesFile)
    - `addressSuggestionsEnableFreeText` boolean — Whether free text input is allowed when auto-complete is on
    - `useNewDesign` boolean — This property is deprecated and will be removed in a future version
    - `thirdPartyCookies` boolean — If false, third-party cookies are disabled to comply with GDPR regulations without asking for consent.
    - `accessMode` 'PUBLIC' | 'PRIVATE'
    - `enableDarkMode` boolean — If true, the journey shows an icon to toggle dark mode
    - `useAustrianLabels` boolean — If true, some journey input labels are in Austrian format
    - `isActive` boolean
    - `savingProgress` object
      - `mode` 'auto' | 'local' | 'remote' | 'none'
      - `supportedRevision` number
  - `validationRules` ValidationRuleRef — References to validation rules organized by blocks and fields. Maps block IDs to either rule IDs (for block-level rules) or rule references (for field-level rules).
  - `_manifest` string[] — Manifest/Blueprint ID used to create/update the entity

## Other responses

- `400` — Validation failed (when validation mode is STRICT)

---

[API](https://skmtc.net/epilot/apis/journey-api.md) · [All operations](https://skmtc.net/epilot/apis/journey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/journey-api/revisions/d19cdc961b84/schema)