# Create journey

Initiates a new web journey (e.g., createAccount) for the specified client_id. Provide journey configuration (account types, service type, optional allocation plan, KYC questions, transfer instructions) plus callback/redirect URLs. The response returns a journey id, a launchable url, status, and metadata you can track until completion.

Endpoint: POST /v2/partner/client/{client_id}/journey
Version: 2.0.0
Security: oAuth

## Path parameters:

  - `client_id` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Request fields (application/json):

  - `journey` (object, required)

  - `callbackUrl` (string, required)
    Url for partner callback
    Example: "https://api.habibisfonder.se/v1/fondo/callback"

  - `redirectUrl` (string,null)
    Redirect URL when leaving the Fondo Journey (BankID etc)
    Example: "customerApp:///"

  - `scope` (string,null, required)
    BASE64 encoded partner specific data attached to the journey, such as encrypted data containing session information. It will be passed back to callback.

## Response 200 fields (application/json):

  - `status` (any)
    The partner/client has to follow the progress

  - `id` (string)
    The ID of web journey.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `clientId` (string)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `url` (string)
    journey url
    Example: "https://webbo.fondo.se/dT7KlfoMrjOspMBvyAq2bvD8cSSAVZg50bAh8G8U6z4nNPRHAy"

  - `expiryDate` (string)
    Date when journey token is considered stale
    Example: "2018-12-13T23:59:00.001Z"

  - `journey` (object, required)

  - `sortedId` (string)
    ULID (Universally Unique Lexicographically Sortable Identifier)
    Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"

  - `createdDate` (string)
    Date when acocunt was created
    Example: "2018-12-13T23:59:00.001Z"

  - `modifiedDate` (string)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `deleted` (boolean)
    True if the journey is deleted

  - `deletedDate` (string,null)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `callbackUrl` (string, required)
    Url for partner callback
    Example: "https://api.habibisfonder.se/v1/fondo/callback"

  - `redirectUrl` (string,null)
    Redirect URL when leaving the Fondo Journey (BankID etc)
    Example: "customerApp:///"

  - `errorCode` (string,null)
    Any errors occurring during journey

  - `context` (string,null)
    Where end-user exited the journey. On error on cancel, if applicable.
    Example: "createaccountsign"

  - `scope` (string,null, required)
    BASE64 encoded partner specific data attached to the journey, such as encrypted data containing session information. It will be passed back to callback.

  - `result` (object,null)
    Result of journey

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error