---
title: "Changes to Creates an invitation to allow a new team member to join an existing service."
method: POST
path: "/v1/api/invites/create-invite-to-join-service"
---

# Changes to Creates an invitation to allow a new team member to join an existing service.

`POST /v1/api/invites/create-invite-to-join-service`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 53 revisions.

- **2026-01-20** `61835ad90a33` — 3 breaking
- **2025-11-25** `61821d66cdcb` — 3 info
- **2025-11-24** `61835ad90a33` — 2 info
- **2025-05-20** `0a185c629789` — 1 breaking
- **2025-04-10** `e1deccce0b14` — 3 breaking
- **2024-09-12** `3f6a3bbb9219` — 1 breaking, 6 info
- **2022-12-19** `6a7bd1eb62a7` — 1 warning
- **2022-12-15** `5163f2c9ccc3` — 1 warning, 1 info
- **2022-12-13** `566e66065caa` — 1 info
- **2022-12-12** `df693274547d` — 1 info

## Changes

- **2026-01-20** `61835ad90a33` — 3 breaking
  - the `email` request property's minLength was increased from `0` to `1`
  - the `sender` request property's minLength was increased from `0` to `1`
  - the `service_external_id` request property's minLength was increased from `0` to `1`
- **2025-11-25** `61821d66cdcb` — 3 info
  - the `email` request property's minLength was decreased from `1` to `0`
  - the `sender` request property's minLength was decreased from `1` to `0`
  - the `service_external_id` request property's minLength was decreased from `1` to `0`
- **2025-11-24** `61835ad90a33` — 2 info
  - added the non-success response with the status `409`
  - added the non-success response with the status `412`
- **2025-05-20** `0a185c629789` — 1 breaking
  - the `email` request property format changed from no format to `email`
- **2025-04-10** `e1deccce0b14` — 3 breaking
  - the `email` request property's minLength was increased from `0` to `1`
  - the `sender` request property's minLength was increased from `0` to `1`
  - the `service_external_id` request property's minLength was increased from `0` to `1`
- **2024-09-12** `3f6a3bbb9219` — 1 breaking, 6 info
  - request property `role_name` was restricted to a list of enum values
  - added the new `admin` enum value to the request property `role_name`
  - added the new `super-admin` enum value to the request property `role_name`
  - added the new `view-and-initiate-moto` enum value to the request property `role_name`
  - added the new `view-and-refund` enum value to the request property `role_name`
  - added the new `view-only` enum value to the request property `role_name`
  - added the new `view-refund-and-initiate-moto` enum value to the request property `role_name`
- **2022-12-19** `6a7bd1eb62a7` — 1 warning
  - removed the optional property `type` from the response with the `201` status
- **2022-12-15** `5163f2c9ccc3` — 1 warning, 1 info
  - removed the optional property `invite_to_join_service` from the response with the `201` status
  - added the optional property `is_invite_to_join_service` to the response with the `201` status
- **2022-12-13** `566e66065caa` — 1 info
  - added the optional property `invite_to_join_service` to the response with the `201` status
- **2022-12-12** `df693274547d` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/government-digital-service/apis/adminusers-api/docs/v1/api/invites/create-invite-to-join-service/post.md) · [API](https://skmtc.dev/government-digital-service/apis/adminusers-api.md) · [Page](https://skmtc.dev/government-digital-service/apis/adminusers-api/changes/v1/api/invites/create-invite-to-join-service/post)