---
title: "Invite a User"
method: POST
path: "/1/accounts/{account}/invitations"
tags: ["User Management"]
---

# Invite a User

`POST /1/accounts/{account}/invitations`

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

## Path parameters

- `account` integer, required

## Query parameters

- `with` string

## Request body

- object
  - `email` string, required — The email address of the user being invited.
  - `first_name` string, required — The first name of the user being invited.
  - `last_name` string, 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.
  - `notifications` object — Notifications configuration for the user.
    - `billing` boolean — Whether or not the user will be able to receive billing notifications. (default: `false`)
    - `products` boolean — Whether or not the user will be able to receive product notifications. (default: `false`)
  - `permissions` object — Permissions configuration for the user.
    - `billing` boolean — Whether or not the user will be able to manage the billing account. (default: `false`)
  - `role_type` 'admin' | 'normal' | 'owner', required — The role to assign to the user upon invitation.
  - `silent` boolean — Whether or not the user will receive the invitation email. (default: `false`)
  - `strict` boolean — Whether or not the user should register with the same email address. (default: `true`)
  - `teams` integer[] — The teams the user should be added to upon invitation.

## Response `201`

Created

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 087adaadAccountInvitation
    - `id` integer, required — Unique identifier of the resource `AccountInvitation`
    - `first_name` string, required — First name
    - `last_name` string, required — Last name
    - `email` string, required — Email
    - `strict` boolean, required
    - `status` 'accepted' | 'cancelled' | 'pending' | 'rejected', required — Status of the resource `AccountInvitation`
    - `role_type` 'admin' | 'normal' | 'owner', required
    - `teams` 087adaadTeam[]
      - `id` integer, required — Unique identifier of the resource `Team`
      - `name` string, required — Name of the resource `Team`
      - `color_id` integer, required — Unique identifier of the `color` of the resource `Team`
      - `created_at` integer, required — Timestamp `Team` has been created
      - `updated_at` integer, required — Timestamp `Team` has been updated
      - `user_count` integer — User count related to the resource `Team`
    - `language_id` integer, required — Unique identifier of the `language` that is related to the resource `AccountInvitation`
    - `locale` string, required — Represents a language identifier and a region identifier
    - `account_id` integer, required — Unique identifier of the `account` that is related to the resource `AccountInvitation`
    - `has_ksuite` boolean, required
    - `has_billing` boolean, required
    - `has_billing_mailing` boolean, required
    - `has_mailing` boolean, required
    - `ksuite` unknown[], nullable
      - unknown
    - `app_accesses` string, nullable
    - `permissions` unknown[]
      - unknown
    - `service_permissions` unknown[]
      - unknown
    - `sent_at` integer, nullable, required
    - `created_at` integer, required — Timestamp `AccountInvitation` has been created
    - `updated_at` integer, required — Timestamp `AccountInvitation` has been updated
    - `expired_at` integer, nullable, required — Timestamp `AccountInvitation` has expired
    - `url_accept` string, required
    - `qr_code` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)