User Management

Invite a User

Create and send an invitation for a new or existing User to join an Account using an email address.

post/1/accounts/{account}/invitations

Path parameters

accountinteger required

Unique identifier of the Account

Query parameters

withstring

Optional : Allows loading additional data about a resource, which may include related resources.

Request body

emailstring required

The email address of the user being invited.

first_namestring required

The first name of the user being invited.

last_namestring required

The last name of the user being invited.

locale'de_DE' | 'en_GB' | 'es_ES' | 'fr_FR' | 'it_IT' required

The locale code for the language of the invitation the user will receive.

role_type'admin' | 'normal' | 'owner' required

The role to assign to the user upon invitation.

silentboolean

Whether or not the user will receive the invitation email. (default: false)

strictboolean

Whether or not the user should register with the same email address. (default: true)

teamsinteger[]

The teams the user should be added to upon invitation.

Response

Created

result'success' | 'error' | 'asynchronous' required

Result of the HTTP request

Example response

{
  "result": "success",
  "data": {
    "language_id": 1,
    "locale": "fr_FR",
    "sent_at": 1745062007,
    "url_accept": "https://welcome.infomaniak.com/invitation/account/1234567890987654321?lang=fr"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.