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

# Changes to Create a role

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 79 revisions.

- **2026-09-24** `34b97bf783a5`: 1 breaking
- **2026-07-10** `c75ca16e1e44`: 2 info
- **2026-03-11** `cd79d83b07e0`: 2 info
- **2025-12-11** `b8fb7c9463b8`: 2 info
- **2025-03-26** `80a17713e7a8`: 1 info

## Changes

- **2026-09-24** `34b97bf783a5`: 1 breaking
  - the `permissions` request property's minItems was increased to `1`
- **2026-07-10** `c75ca16e1e44`: 2 info
  - the security scope `roles.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `user.subaccounts` was added to the endpoint's security scheme `oauth2`
- **2026-03-11** `cd79d83b07e0`: 2 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`
- **2025-12-11** `b8fb7c9463b8`: 2 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
- **2025-03-26** `80a17713e7a8`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/sumup/apis/sumup-rest-api/docs/v0.1/merchants/:merchant_code/roles/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/roles/post)