---
title: "Create a kSuite access"
method: POST
path: "/1/accounts/{account}/invitations/{invitation}/ksuite"
tags: ["User Management > Accounts > Invitations > kSuite"]
---

# Create a kSuite access

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

This API endpoint allows you to create access to the kSuite for an invitation of a user in an account.

## Path parameters

- `account` string, required
- `invitation` string, required

## Request body

- object
  - `ksuite_access` object, required
    - `kchat_role` 'admin' | 'user', required
    - `kdrive_role` 'admin' | 'user', required
  - `mailbox_name` string
  - `mailbox_permissions` object
    - `can_access_logs` boolean
    - `can_change_password` boolean
    - `can_configure_mail_folders` boolean
    - `can_delegate` boolean
    - `can_manage_aliases` boolean
    - `can_manage_auto_reply` boolean
    - `can_manage_filters` boolean
    - `can_manage_redirections` boolean
    - `can_manage_security` boolean
    - `can_manage_signatures` boolean
    - `can_send_emails` boolean
  - `mailbox_signature_model_id` string, nullable

## 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` 087adaadTeam7471c6bd[]
      - `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`
      - `users` string
      - `parent_id` string
      - `children` string, required
      - `owners` string
      - `description` string, nullable, required — Description of the resource `Team`
      - `logo` string, required
    - `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

- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-09-14** `8c78546bf41f` — 7 info
  - added the new optional request property `mailbox_permissions/can_delegate`
  - added the optional property `allOf[subschema #2]/data/teams/items/owners` to the response with the `201` status
  - added the optional property `allOf[subschema #2]/data/teams/items/parent_id` to the response with the `201` status
  - added the optional property `allOf[subschema #2]/data/teams/items/users` to the response with the `201` status
  - …3 more

[Change history](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/changes/1/accounts/:account/invitations/:invitation/ksuite/post.md)

---

[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.dev/infomaniak/apis/api-reference-developer-tools/revisions/f11860e74a00?raw)