---
title: "Changes to Create User Journey"
method: POST
path: "/api/v2/user_journeys"
---

# Changes to Create User Journey

`POST /api/v2/user_journeys`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 19 revisions.

- **2026-03-20** `f30bd25c50fa` — 1 warning, 1 info
- **2026-03-09** `fd9ba8047579` — 2 info
- **2026-03-09** `3f638e7bcdd4` — 13 breaking, 52 warning, 28 info
- **2025-07-31** `33c1d5958395` — 2 warning, 2 info
- **2025-05-19** `805744a185fa` — 1 info
- **2024-06-11** `6cde27481f55` — 1 breaking

## Changes

- **2026-03-20** `f30bd25c50fa` — 1 warning, 1 info
  - added the new `voided` enum value to the `state` response property for the response status `201`
  - added the new `voided` enum value to the request property `state`
- **2026-03-09** `fd9ba8047579` — 2 info
  - added `#/components/schemas/Models.OfficeLocation` to the `office_location` response property `anyOf` list for the response status `201`
  - removed `#/components/schemas/OfficeLocation` from the `office_location` response property `anyOf` list for the response status `201`
- **2026-03-09** `3f638e7bcdd4` — 13 breaking, 52 warning, 28 info
  - request property `state` was restricted to a list of enum values
  - request property `transition_type` was restricted to a list of enum values
  - the `custom_fields` request property type/format changed from ``/`` to `object`/``
  - the `documents/items/attachments/items/file_content_base64` request property type/format changed from `string`/`` to `string`/`Base64`
  - the `office_location_id` request property type/format changed from `object`/`` to ``/``
  - the `state` request property type/format changed from ``/`` to `string`/``
  - the `user_id` request property type/format changed from `string`/`` to ``/``
  - added 'unevaluatedProperties' constraint to the request property `custom_fields`
  - the `custom_field_values` response's property type/format changed from ``/`` to `array`/`` for status `201`
  - the `office_location` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `state` response's property type/format changed from ``/`` to `string`/`` for status `201`
  - removed the required property `office_location/external_ids` from the response with the `201` status
  - removed the required property `office_location/id` from the response with the `201` status
  - removed `#/components/schemas/CustomFieldsValueObject` from the `custom_fields` request property `allOf` list
  - removed `#/components/schemas/UserJourneyState` from the `state` request property `allOf` list
  - removed the request property `created_at`
  - removed the request property `documents/items/attachments/items/responses`
  - removed the request property `documents/items/expiry_date`
  - removed the request property `documents/items/issued_date`
  - removed the request property `documents/items/issuer`
  - removed the request property `documents/items/issuer_city`
  - removed the request property `documents/items/issuer_country`
  - removed the request property `documents/items/issuer_state`
  - removed the request property `journey_id`
  - removed the request property `office_location_id/address1`
  - removed the request property `office_location_id/address2`
  - removed the request property `office_location_id/address3`
  - removed the request property `office_location_id/city`
  - removed the request property `office_location_id/country`
  - removed the request property `office_location_id/external_ids`
  - removed the request property `office_location_id/id`
  - removed the request property `office_location_id/latitude`
  - removed the request property `office_location_id/longitude`
  - removed the request property `office_location_id/postal_code`
  - removed the request property `office_location_id/region`
  - removed the request property `office_location_id/state`
  - removed the request property `office_location_id/time_zone`
  - removed the request property `office_location_id/workday`
  - removed the optional property `office_location/address1` from the response with the `201` status
  - removed the optional property `office_location/address2` from the response with the `201` status
  - …53 more
- **2025-07-31** `33c1d5958395` — 2 warning, 2 info
  - removed the request property `journey_type`
  - removed the optional property `journey_type` from the response with the `201` status
  - added the new optional request property `transition_type`
  - added the optional property `transition_type` to the response with the `201` status
- **2025-05-19** `805744a185fa` — 1 info
  - endpoint added
- **2024-06-11** `6cde27481f55` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/xpand-io/apis/xpand-api/docs/api/v2/user_journeys/post.md) · [API](https://skmtc.dev/xpand-io/apis/xpand-api.md) · [Page](https://skmtc.dev/xpand-io/apis/xpand-api/changes/api/v2/user_journeys/post)