---
title: "Changes to Create Consumer"
method: POST
path: "/api/v2/consumers"
---

# Changes to Create Consumer

`POST /api/v2/consumers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 16 revisions.

- **2026-11-05** `9c73cbd109e4`: 3 info
- **2026-10-28** `bb23366f1a76`: 2 info
- **2026-10-09** `dfac786362d9`: 1 breaking, 2 warning, 6 info
- **2026-09-03** `515eeea7d260`: 2 breaking, 2 info
- **2026-07-15** `9a960de24945`: 1 breaking, 10 warning, 6 info

## Changes

- **2026-11-05** `9c73cbd109e4`: 3 info
  - added the optional property `created_by_id` to the response with the `200` status
  - added the optional property `created_by_type` to the response with the `200` status
  - added the optional property `organization_id` to the response with the `200` status
- **2026-10-28** `bb23366f1a76`: 2 info
  - added the new optional request property `fields`
  - added the optional property `fields` to the response with the `200` status
- **2026-10-09** `dfac786362d9`: 1 breaking, 2 warning, 6 info
  - added the new required request property `address/street`
  - removed the request property `address/address_line_1`
  - removed the request property `address/address_line_2`
  - added the new optional request property `address/building_number`
  - added the new optional request property `address/district`
  - added the optional property `address/building_number` to the response with the `200` status
  - added the optional property `address/district` to the response with the `200` status
  - added the optional property `address/street` to the response with the `200` status
  - the response optional property `address/address_line_1` became read-only for the status `200`
- **2026-09-03** `515eeea7d260`: 2 breaking, 2 info
  - added the new required request property `beneficiaries/items/name`
  - the `beneficiaries/items/` request property type changed from `string` to `object`
  - added the new optional request property `beneficiaries/items/fields`
  - added the optional property `beneficiaries/items/fields` to the response with the `200` status
- **2026-07-15** `9a960de24945`: 1 breaking, 10 warning, 6 info
  - request property `preferred_language` was restricted to a list of enum values
  - the `alias` request property's maxLength was set to `512`
  - the `comment` request property's maxLength was set to `512`
  - the `commercial_registration` request property's maxLength was set to `512`
  - the `external_id` request property's maxLength was set to `512`
  - the `name` request property's maxLength was set to `512`
  - the `vat_number` request property's maxLength was set to `64`
  - added the new `AR` enum value to the `consumer/preferred_language` response property for the response status `200`
  - added the new `AR` enum value to the `preferred_language` response property for the response status `200`
  - added the new `EN` enum value to the `consumer/preferred_language` response property for the response status `200`
  - added the new `EN` enum value to the `preferred_language` response property for the response status `200`
  - added the new optional request property `beneficiaries`
  - added the new optional request property `external_metadata`
  - added the new `AR` enum value to the request property `preferred_language`
  - added the new `EN` enum value to the request property `preferred_language`
  - added the optional property `beneficiaries` to the response with the `200` status
  - added the optional property `external_metadata` to the response with the `200` status

---

[Operation](https://skmtc.dev/streampay/apis/stream-app/docs/api/v2/consumers/post.md) - [API](https://skmtc.dev/streampay/apis/stream-app.md) - [Page](https://skmtc.dev/streampay/apis/stream-app/changes/api/v2/consumers/post)