---
title: "Changes to Create a new Virtual Reference Number"
method: POST
path: "/virtual_reference_numbers"
---

# Changes to Create a new Virtual Reference Number

`POST /virtual_reference_numbers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-09-25** `5f8163e29af4`: 3 info
- **2026-08-21** `54f4fe726d8f`: 3 breaking, 1 warning, 1 info

## Changes

- **2026-09-25** `5f8163e29af4`: 3 info
  - added the new optional request property `type`
  - added the non-success response with the status `400`
  - added the optional property `allOf[subschema #1]/type` to the response with the `201` status
- **2026-08-21** `54f4fe726d8f`: 3 breaking, 1 warning, 1 info
  - added `#/components/schemas/0` to the `external_uid` request property `allOf` list
  - the `name` request property type changed from no type to `string`
  - the `allOf[subschema #1]/name` response's property type changed from no type to `string` for status `201`
  - the `name` request property's maxLength was set to `255`
  - added `#/components/schemas/0` to the `allOf[subschema #1]/external_uid` response property `allOf` list for the response status `201`

---

[Operation](https://skmtc.dev/newline53/apis/newline-platform-api/docs/virtual_reference_numbers/post.md) - [API](https://skmtc.dev/newline53/apis/newline-platform-api.md) - [Page](https://skmtc.dev/newline53/apis/newline-platform-api/changes/virtual_reference_numbers/post)