---
title: "Changes to Invite customers"
method: POST
path: "/customers/invitations"
---

# Changes to Invite customers

`POST /customers/invitations`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 14 of 28 revisions.

- **2026-08-27** `359d267dca88` — 1 info
- **2026-08-27** `feb2ede06539` — 1 warning, 1 info
- **2026-08-23** `b1ad79e918ac` — 7 warning, 2 info
- **2026-08-19** `a77f94c2883a` — 1 warning, 1 info
- **2026-08-18** `a4ce0bec5315` — 1 breaking, 2 info
- **2026-08-16** `d977b644015a` — 1 breaking, 1 info
- **2026-08-15** `09487fd56e29` — 5 info
- **2026-08-13** `ba1fb54c5939` — 1 info
- **2026-08-11** `089aed4017a8` — 2 breaking, 2 info
- **2026-08-09** `0123533d8361` — 2 info
- **2026-08-07** `9561339ea461` — 2 info
- **2026-08-02** `983d5c234522` — 1 warning, 1 info
- **2026-07-31** `8a3cf2b14c08` — 1 info
- **2026-07-26** `270e233e401c` — 2 breaking, 1 warning, 3 info

## Changes

- **2026-08-27** `359d267dca88` — 1 info
  - deleted the `header` request parameter `X-Agent-ID` with deprecation
- **2026-08-27** `feb2ede06539` — 1 warning, 1 info
  - added the new `CONNECTION_ESTABLISHED` enum value to the `data/items/attributes/cancelReason/anyOf[subschema #1]/` response property for the response status `201`
  - added the required property `meta/alreadyConnected` to the response with the `201` status
- **2026-08-23** `b1ad79e918ac` — 7 warning, 2 info
  - removed the request property `data/attributes/disableNotifications`
  - removed the request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/accountType`
  - removed the request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/business`
  - removed the request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/firstName`
  - removed the request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/individual`
  - removed the request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/lastName`
  - removed the request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/phone`
  - `header` request parameter `X-Agent-ID` was deprecated
  - added the new `wallets.balance` enum value to the request property `data/attributes/agents/items/permissions/items/`
- **2026-08-19** `a77f94c2883a` — 1 warning, 1 info
  - removed the request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/beneficialOwners`
  - added the new optional request property `data/attributes/recipients/items/anyOf[subschema #1: Email recipient]/business/beneficialOwners`
- **2026-08-18** `a4ce0bec5315` — 1 breaking, 2 info
  - removed `subschema #1, subschema #2, subschema #3` from the `data/attributes/recipients/items/` request property `anyOf` list
  - added the new optional request property `data/attributes/message`
  - added `subschema #1: Email recipient, subschema #2: Phone recipient, subschema #3: Existing customer` to the `data/attributes/recipients/items/` request property `anyOf` list
- **2026-08-16** `d977b644015a` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the `data/attributes/recipients/items/` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `data/attributes/recipients/items/` request property `anyOf` list
- **2026-08-15** `09487fd56e29` — 5 info
  - added the new `wallets.create` enum value to the request property `data/attributes/agents/items/permissions/items/`
  - added the new `wallets.deposit` enum value to the request property `data/attributes/agents/items/permissions/items/`
  - added the new `wallets.fund` enum value to the request property `data/attributes/agents/items/permissions/items/`
  - added the new `wallets.transfer` enum value to the request property `data/attributes/agents/items/permissions/items/`
  - added the new `wallets.withdraw` enum value to the request property `data/attributes/agents/items/permissions/items/`
- **2026-08-13** `ba1fb54c5939` — 1 info
  - the `data/attributes/tags/propertyNames/` request property's maxLength was increased from `64` to `128`
- **2026-08-11** `089aed4017a8` — 2 breaking, 2 info
  - removed the enum value `direct_payments.create` of the request property `data/attributes/agents/items/permissions/items/`
  - removed the enum value `direct_payments.read` of the request property `data/attributes/agents/items/permissions/items/`
  - added the new `direct.create` enum value to the request property `data/attributes/agents/items/permissions/items/`
  - added the new `direct.read` enum value to the request property `data/attributes/agents/items/permissions/items/`
- **2026-08-09** `0123533d8361` — 2 info
  - added the new `direct_payments.create` enum value to the request property `data/attributes/agents/items/permissions/items/`
  - added the new `direct_payments.read` enum value to the request property `data/attributes/agents/items/permissions/items/`
- **2026-08-07** `9561339ea461` — 2 info
  - added the new `external_parties.create` enum value to the request property `data/attributes/agents/items/permissions/items/`
  - added the new `external_parties.read` enum value to the request property `data/attributes/agents/items/permissions/items/`
- **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` — 2 breaking, 1 warning, 3 info
  - removed `subschema #1, subschema #2, subschema #3` from the `data/attributes/recipients/items/` request property `anyOf` list
  - the `data/attributes/tags/propertyNames/` request property's maxLength was decreased to `64`
  - the `data/attributes/expiresAt` request property's maxLength was set to `64`
  - added `subschema #1, subschema #2, subschema #3` to the `data/attributes/recipients/items/` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `meta/failedRecipients/items/recipient` response property `anyOf` list for the response status `201`
  - removed `subschema #1, subschema #2, subschema #3` from the `meta/failedRecipients/items/recipient` response property `anyOf` list for the response status `201`

---

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