---
title: "Create a new team"
method: POST
path: "/account/{account_id}/teams"
tags: ["Account"]
deprecated: true
---

# Create a new team

`POST /account/{account_id}/teams`

> **Deprecated.**

Teams have been replaced by groups. To make the transition to groups smoother, migrate your teams to groups. Members of the Account Owners team are automatically made super admin. You can change their access level by revoking super admin privileges, or by granting other roles and permissions.

The API endpoint /v1/account/{account\_id}/teams is deprecated. Use https://api.aiven.io/v1/organization/{organization\_id}/user-groups instead. It will be removed on 2026-03-11.

## Path parameters

- `account_id` string, required

## Response `200`

Response

- AccountTeamCreateResponse — AccountTeamCreateResponse
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request
  - `team` object, required — Account Team details
    - `account_id` string — Account ID
    - `create_time` string — Timestamp in ISO 8601 format, always in UTC
    - `team_id` string, required — Team ID
    - `team_name` string, required — Team name
    - `update_time` string — Timestamp in ISO 8601 format, always in UTC

## Other responses

- `400` — Invalid request parameters
- `403` — Operation not allowed
- `404` — Account not found

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/versions/ecaeabf1da31/schema)