---
title: "Create a Team"
method: POST
path: "/1/accounts/{account}/teams"
tags: ["User Management > Teams"]
---

# Create a Team

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

Create a Team for a given Account.

## Path parameters

- `account` integer, required

## Request body

- object
  - `app_accesses` object
    - `drive` object
      - `folders` object[]
        - `access` 'manage' | 'read' | 'write', required
        - `id` integer, required — Unique identifier of the resource `{name}`
        - `name` string, required — Name of the resource Team
    - `kchat` object
      - `channels` object[]
        - `id` string, required — Unique identifier of the resource `{name}`
        - `name` string, required — Name of the resource Team
    - `mail` object
      - `mailboxes` object[]
        - `domain_name` string, required
        - `localpart` string, required
        - `permissions` object, required — Permissions of the resource Team
          - `can_access_logs` boolean, required
          - `can_change_password` boolean, required
          - `can_configure_mail_folders` boolean, required
          - `can_manage_aliases` boolean, required
          - `can_manage_auto_reply` boolean, required
          - `can_manage_filters` boolean, required
          - `can_manage_redirections` boolean, required
          - `can_manage_rules` boolean, required
          - `can_manage_security` boolean, required
          - `can_manage_signatures` boolean, required
          - `can_restore_emails` boolean, required
          - `can_send_emails` boolean
        - `service_mail_id` integer, required
  - `color` integer
  - `name` string, required — Name of the resource Team
  - `owned_by_id` integer — Unique identifier of the user that owned the resource Team
  - `owned_by_ids` integer[] — Array of user IDs who are owners of the team
  - `permissions` object — Permissions of the resource Team
    - `services` integer[]
  - `user_ids` integer[]

## Response `201`

Created

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 087adaadTeamDb41ff58
    - `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`
    - `owned_by_id` integer, nullable, required — Unique identifier of the `user` that owned the resource `Team`
    - `created_by_id` integer, nullable, required — Unique identifier of the `user` that created the resource `Team`
    - `created_at` integer, required — Timestamp `Team` has been created
    - `updated_at` integer, required — Timestamp `Team` has been updated
    - `created_by` 087adaadUser
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `owned_by` 087adaadUser
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `user_count` integer — User count related to the resource `Team`
    - `product_count` integer — Product count related to the resource `Team`
    - `product_by_service_count` integer — Product by service count related to the resource `Team`
    - `owners` 087adaadUser[], required
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `is_sso` boolean, required
    - `permissions` 087adaadServicepermissions[], required
      - `service_id` integer, required — Unique identifier of the `service` that is related to the resource `Service permissions`
      - `service_name` string, required — Name of the service
      - `rights` 'check' | 'linked' | 'sale' | 'statistic' | 'technical', required
    - `products` 087adaadProductTeamPermissions[]
      - `product_unique_id` integer, required
      - `service_id` integer, required — Unique identifier of the `service` that is related to the resource `Product Team Permissions`
      - `product_id` integer, required — Unique identifier of the `product` that is related to the resource `Product Team Permissions`
      - `product_name` string, required
      - `rights` string[], required
    - `users` 087adaadUser[]
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `app_access` object
      - `mail` object, required
        - `mailboxes` unknown[], required
          - unknown
      - `drive` object, required
        - `folders` unknown[], required
          - unknown
      - `kchat` object, required
        - `channels` unknown[], required
          - unknown

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[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/158a854b0c7d/schema)