---
title: "Create team"
method: POST
path: "/api/user/teams"
tags: ["Teams"]
---

# Create team

`POST /api/user/teams`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/user/teams`
- Auth: API key in cookie `hk_token`

Creates a new team and returns the created team payload.

## Request body

- object
  - `logo_url` string
  - `name` string, required

## Response `201`

Created team

- TeamCreateResponse
  - `team` Team
    - `created_at` string, date-time
    - `entitlements` TeamEntitlements
      - `allow_custom_branding` boolean
      - `allow_external_report_recipients` boolean: Whether scheduled reports may be sent to confirmed addresses outside the team.
      - `allow_sso` boolean
      - `max_retention_days` integer
      - `max_sites_per_team` integer
      - `max_team_members` integer
    - `id` string, uuid
    - `logo_url` string
    - `name` string
    - `plan` TeamPlan
      - `code` string
      - `name` string
      - `support_url` string
      - `upgrade_url` string
    - `role` string
    - `usage` TeamUsageSummary
      - `current_members` integer
      - `current_pending_invites` integer
      - `current_sites` integer

## Other responses

- `400`: Invalid request
- `403`: Team limit reached

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)