---
title: "Changes to Create payment request"
method: POST
path: "/payment-requests"
---

# Changes to Create payment request

`POST /payment-requests`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 28 revisions.

- **2026-08-27** `359d267dca88` — 1 info
- **2026-08-23** `b1ad79e918ac` — 1 warning, 1 info
- **2026-08-13** `ba1fb54c5939` — 2 info
- **2026-08-02** `983d5c234522` — 1 warning, 1 info
- **2026-07-31** `8a3cf2b14c08` — 1 info
- **2026-07-26** `270e233e401c` — 3 breaking, 2 warning, 8 info
- **2026-07-14** `8cc2aed45847` — 2 info

## Changes

- **2026-08-27** `359d267dca88` — 1 info
  - deleted the `header` request parameter `X-Agent-ID` with deprecation
- **2026-08-23** `b1ad79e918ac` — 1 warning, 1 info
  - removed the request property `data/attributes/disableNotifications`
  - `header` request parameter `X-Agent-ID` was deprecated
- **2026-08-13** `ba1fb54c5939` — 2 info
  - added the new optional request property `data/attributes/tags`
  - added the required property `data/attributes/tags` to the response with the `201` status
- **2026-08-02** `983d5c234522` — 1 warning, 1 info
  - removed the request property `data/attributes/suppressNotifications`
  - added the new optional request property `data/attributes/disableNotifications`
- **2026-07-31** `8a3cf2b14c08` — 1 info
  - added the new optional request property `data/attributes/suppressNotifications`
- **2026-07-26** `270e233e401c` — 3 breaking, 2 warning, 8 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` from the `data/attributes/payer` request property `anyOf` list
  - the `data/attributes/description` request property's maxLength was decreased to `80`
  - the `data/attributes/description/anyOf[subschema #1]/` response property's maxLength was unset from `500` for the response status `201`
  - for the `header` request parameter `Idempotency-Key`, the maxLength was set to `255`
  - the `data/attributes/payerName` request property's maxLength was set to `32`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `data/attributes/payer` request property `anyOf` list
  - added the required property `data/attributes/initiatorAgent` to the response with the `201` status
  - added the required property `data/attributes/initiatorParty` to the response with the `201` status
  - added the required property `data/attributes/payerCanDecline` to the response with the `201` status
  - added the required property `data/attributes/payerCanPay` to the response with the `201` status
  - added the required property `data/attributes/payerHandle` to the response with the `201` status
  - added the required property `data/attributes/requesterHandle` to the response with the `201` status
  - added the required property `data/attributes/walletName` to the response with the `201` status
- **2026-07-14** `8cc2aed45847` — 2 info
  - added the required property `data/attributes/payerAvatarUrl` to the response with the `201` status
  - added the required property `data/attributes/requesterAvatarUrl` to the response with the `201` status

---

[Operation](https://skmtc.dev/natural/apis/natural-api/docs/payment-requests/post.md) · [API](https://skmtc.dev/natural/apis/natural-api.md) · [Page](https://skmtc.dev/natural/apis/natural-api/changes/payment-requests/post)