---
title: "Changes to Create a Reader"
method: POST
path: "/v0.1/merchants/{merchant_code}/readers"
---

# Changes to Create a Reader

`POST /v0.1/merchants/{merchant_code}/readers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 79 revisions.

- **2026-07-10** `c75ca16e1e44`: 1 info
- **2026-03-11** `cd79d83b07e0`: 3 info
- **2026-02-09** `636f9c4e9fc8`: 1 info
- **2025-12-11** `b8fb7c9463b8`: 2 warning, 5 info
- **2025-10-29** `4dc4b073a6a9`: 3 breaking
- **2025-03-26** `80a17713e7a8`: 1 info
- **2025-02-25** `cdadac3315a1`: 2 info
- **2024-07-08** `770aa855de22`: 1 info
- **2024-02-22** `d566a132d953`: 1 breaking
- **2024-02-19** `51805d248594`: 1 info

## Changes

- **2026-07-10** `c75ca16e1e44`: 1 info
  - the security scope `terminals.write` was added to the endpoint's security scheme `oauth2`
- **2026-03-11** `cd79d83b07e0`: 3 info
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `400`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `404`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `409`
- **2026-02-09** `636f9c4e9fc8`: 1 info
  - added the optional property `service_account_id` to the response with the `201` status
- **2025-12-11** `b8fb7c9463b8`: 2 warning, 5 info
  - removed the request property `meta`
  - removed the optional property `meta` from the response with the `201` status
  - added the new optional request property `metadata`
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the optional property `metadata` to the response with the `201` status
- **2025-10-29** `4dc4b073a6a9`: 3 breaking
  - the request property `name` became required
  - the `meta/additionalProperties/` request property type changed from no type to `string`
  - the `meta/additionalProperties/` response's property type changed from no type to `string` for status `201`
- **2025-03-26** `80a17713e7a8`: 1 info
  - the security scope `readers.write` was added to the endpoint's security scheme `oauth2`
- **2025-02-25** `cdadac3315a1`: 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `oauth2` was added to the API
- **2024-07-08** `770aa855de22`: 1 info
  - endpoint added
- **2024-02-22** `d566a132d953`: 1 breaking
  - api path removed without deprecation
- **2024-02-19** `51805d248594`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/sumup/apis/sumup-rest-api/docs/v0.1/merchants/:merchant_code/readers/post.md) - [API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) - [Page](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/merchants/:merchant_code/readers/post)