---
title: "POST /teams"
method: POST
path: "/teams"
tags: ["teams"]
---

# POST /teams

`POST /teams`

Create a team owned by the current user.

## Request body

- object
  - `name` string, required — The unique name for the team.
  - `display_name` string, required — The team's display name

## Response `201`

Created

- Team — CloudQuery Team
  - `created_at` string, date-time
  - `name` string, required — The unique name for the team.
  - `plan` 'free' | 'paid' | 'enterprise' | 'trial', required — The plan the team is on (trial is deprecated)
  - `plan_end_time` string, date-time
  - `is_trial_active` boolean, required
  - `trial_end_time` string, date-time
  - `trial_eligible` boolean, required — The team has not had its trial yet and will start one on its first sync that reports rows.
  - `display_name` string, required — The team's display name
  - `internal` boolean, required

## Other responses

- `400` — Bad request
- `401` — Requires authentication
- `403` — Forbidden
- `422` — UnprocessableEntity
- `500` — Internal Error

## Changes

- **2026-08-11** `ef9782a3ed5e` — 1 info
  - added the required property `trial_eligible` to the response with the `201` status

[Change history](https://skmtc.dev/cloudquery/apis/cloudquery-openapi-spec/changes/teams/post.md)

---

[API](https://skmtc.dev/cloudquery/apis/cloudquery-openapi-spec.md) · [All operations](https://skmtc.dev/cloudquery/apis/cloudquery-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudquery/cloudquery-openapi-spec/revisions/ef9782a3ed5e/schema)