---
title: "Changes to Invite a user to join an organization"
method: POST
path: "/v1beta/organizations/{organization_id}/invites"
---

# Changes to Invite a user to join an organization

`POST /v1beta/organizations/{organization_id}/invites`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 59 revisions.

- **2026-03-19** `885f41a57639`: 8 info
- **2026-03-16** `cb42a69ce465`: 2 breaking
- **2026-03-05** `a7e69986914e`: 2 breaking, 4 info
- **2026-02-25** `8f9853bb76e0`: 1 breaking, 4 warning, 5 info
- **2026-02-19** `64f492271548`: 6 breaking, 18 info
- **2026-02-16** `48d20b27da71`: 1 warning, 7 info
- **2026-02-09** `ebc87ccf613e`: 1 breaking, 7 info

## Changes

- **2026-03-19** `885f41a57639`: 8 info
  - api tag `Invites` added
  - api tag `Organizations` removed
  - added the optional property `invite/accepted_by/family_name` to the response with the `200` status
  - added the optional property `invite/accepted_by/given_name` to the response with the `200` status
  - added the optional property `invite/accepted_by/profile_image_url` to the response with the `200` status
  - added the optional property `invite/sender/family_name` to the response with the `200` status
  - added the optional property `invite/sender/given_name` to the response with the `200` status
  - added the optional property `invite/sender/profile_image_url` to the response with the `200` status
- **2026-03-16** `cb42a69ce465`: 2 breaking
  - the request property `idempotency_key` became not nullable
  - the request property `message` became not nullable
- **2026-03-05** `a7e69986914e`: 2 breaking, 4 info
  - removed the required property `invite/accepted_by/type` from the response with the `200` status
  - removed the required property `invite/sender/type` from the response with the `200` status
  - the `invite/accepted_by/id` response's property pattern was changed from `^(user|svc)_[0-9a-hjkmnp-tv-z]{26}$` to `^user_[0-9a-hjkmnp-tv-z]{26}$` for the status `200`
  - the `invite/sender/id` response's property pattern was changed from `^(user|svc)_[0-9a-hjkmnp-tv-z]{26}$` to `^user_[0-9a-hjkmnp-tv-z]{26}$` for the status `200`
  - added the required property `invite/accepted_by/email` to the response with the `200` status
  - added the required property `invite/sender/email` to the response with the `200` status
- **2026-02-25** `8f9853bb76e0`: 1 breaking, 4 warning, 5 info
  - the `invite/status` response's property type changed from `string` to no type for status `200`
  - added the new `accepted` enum value to the `invite/status` response property for the response status `200`
  - added the new `expired` enum value to the `invite/status` response property for the response status `200`
  - added the new `pending` enum value to the `invite/status` response property for the response status `200`
  - added the new `revoked` enum value to the `invite/status` response property for the response status `200`
  - removed the `ORGANIZATION_INVITE_STATUS_ACCEPTED` enum value from the `invite/status` response property for the response status `200`
  - removed the `ORGANIZATION_INVITE_STATUS_EXPIRED` enum value from the `invite/status` response property for the response status `200`
  - removed the `ORGANIZATION_INVITE_STATUS_PENDING` enum value from the `invite/status` response property for the response status `200`
  - removed the `ORGANIZATION_INVITE_STATUS_REVOKED` enum value from the `invite/status` response property for the response status `200`
  - removed the `ORGANIZATION_INVITE_STATUS_UNSPECIFIED` enum value from the `invite/status` response property for the response status `200`
- **2026-02-19** `64f492271548`: 6 breaking, 18 info
  - removed the required property `error` from the response with the `400` status
  - removed the required property `error` from the response with the `401` status
  - removed the required property `error` from the response with the `403` status
  - removed the required property `error` from the response with the `404` status
  - removed the required property `error` from the response with the `429` status
  - removed the required property `error` from the response with the `500` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `details` to the response with the `403` status
  - added the optional property `details` to the response with the `404` status
  - added the optional property `details` to the response with the `429` status
  - added the optional property `details` to the response with the `500` status
  - added the required property `code` to the response with the `400` status
  - added the required property `code` to the response with the `401` status
  - added the required property `code` to the response with the `403` status
  - added the required property `code` to the response with the `404` status
  - added the required property `code` to the response with the `429` status
  - added the required property `code` to the response with the `500` status
  - added the required property `message` to the response with the `400` status
  - added the required property `message` to the response with the `401` status
  - added the required property `message` to the response with the `403` status
  - added the required property `message` to the response with the `404` status
  - added the required property `message` to the response with the `429` status
  - added the required property `message` to the response with the `500` status
- **2026-02-16** `48d20b27da71`: 1 warning, 7 info
  - removed the request property `organization_id`
  - api tag `OrganizationService` removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
- **2026-02-09** `ebc87ccf613e`: 1 breaking, 7 info
  - added the new required request property `organization_id`
  - api tag `OrganizationService` added
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`

---

[Operation](https://skmtc.dev/factify-inc/apis/factify-api/docs/v1beta/organizations/:organization_id/invites/post.md) - [API](https://skmtc.dev/factify-inc/apis/factify-api.md) - [Page](https://skmtc.dev/factify-inc/apis/factify-api/changes/v1beta/organizations/:organization_id/invites/post)
