---
title: "Changes to POST /tenants/self/invitations"
method: POST
path: "/tenants/self/invitations"
---

# Changes to POST /tenants/self/invitations

`POST /tenants/self/invitations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 22 revisions.

- **2024-11-06** `6e59d7e846f5`: 2 info
- **2022-08-10** `9a8cb945aa48`: 1 breaking, 1 warning, 7 info

## Changes

- **2024-11-06** `6e59d7e846f5`: 2 info
  - added the new optional request property `role`
  - added the optional property `role` to the response with the `201` status
- **2022-08-10** `9a8cb945aa48`: 1 breaking, 1 warning, 7 info
  - request body became required
  - the `email` request property's maxLength was set to `330`
  - api operation id `TenantInvitations.Create` removed and replaced with `TenantInvitations_CreateInvitation`
  - api tag `Tenants` added
  - api tag `TenantInvitations` removed
  - the `created_by` response's property pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`
  - the `id` response's property pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`
  - the `modified_by` response's property pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`
  - the `tenant_id` response's property pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`

---

[Operation](https://skmtc.dev/basistheory/apis/basis-theory-api/docs/tenants/self/invitations/post.md) - [API](https://skmtc.dev/basistheory/apis/basis-theory-api.md) - [Page](https://skmtc.dev/basistheory/apis/basis-theory-api/changes/tenants/self/invitations/post)