Sign in

v52

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-03432547.1 KB
Invites

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

post/v1/api/invites/create-invite-to-join-service

Request body

emailstring email required
role_name'admin' | 'view-and-refund' | 'view-only' | 'view-and-initiate-moto' | 'view-refund-and-initiate-moto' | 'super-admin' required
senderstring required

User external ID

service_external_idstring required

Example request

{
  "email": "example@example.gov.uk",
  "role_name": "view-only",
  "sender": "d0wksn12nklsdf1nd02nd9n2ndk",
  "service_external_id": "dj2jkejke32jfhh3"
}

Response

Created

attempt_counterinteger
disabledboolean
emailstring
expiredboolean
inviteLinkstring
is_invite_to_join_serviceboolean
otp_keystring
password_setboolean
rolestring
telephone_numberstring
user_existboolean

Example response

{
  "_links": [
    {
      "href": "https://an.example.link",
      "method": "GET",
      "rel": "self"
    }
  ],
  "email": "example@example.gov.uk",
  "is_invite_to_join_service": true,
  "otp_key": "ABC123",
  "role": "view-only",
  "telephone_number": "+440787654534"
}