---
title: "Create team REST API | HitKeep"
description: "Reference for the HitKeep REST API operation Create team, including request parameters, responses, and authentication notes."
canonical: "https://hitkeep.com/api/operations/apiuserteams/post/"
---

# Create team REST API

POST

/api/user/teams

FetchcURL

```
const url = 'http://127.0.0.1:25737/api/user/teams';
const options = {
  method: 'POST',
  headers: {cookie: 'hk_token=<hk_token>', 'Content-Type': 'application/json'},
  body: '{"logo_url":"example","name":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```
curl --request POST \
  --url http://127.0.0.1:25737/api/user/teams \
  --header 'Content-Type: application/json' \
  --cookie hk_token=<hk_token> \
  --data '{ "logo_url": "example", "name": "example" }'
```

-

Creates a new team and returns the created team payload.

## Authorizations

- **[cookieAuth](https://hitkeep.com/api/#cookieauth)**

## Request Bodyrequired

application/json

object

**logo_url**

string

**name**

required

string

##### Examplegenerated

```
{
  "logo_url": "example",
  "name": "example"
}
```

## Responses

### 201

Created team

application/json

object

**team**

object

**created_at**

string format: date-time

**entitlements**

object

**allow_custom_branding**

boolean

**allow_external_report_recipients**

Whether scheduled reports may be sent to confirmed addresses outside the team.

boolean

**allow_sso**

boolean

**max_retention_days**

integer

**max_sites_per_team**

integer

**max_team_members**

integer

**id**

string format: uuid

**logo_url**

string

**name**

string

**plan**

object

**code**

string

**name**

string

**support_url**

string

**upgrade_url**

string

**role**

string

**usage**

object

**current_members**

integer

**current_pending_invites**

integer

**current_sites**

integer

##### Examplegenerated

```
{
  "team": {
    "created_at": "2026-04-15T12:00:00Z",
    "entitlements": {
      "allow_custom_branding": true,
      "allow_external_report_recipients": true,
      "allow_sso": true,
      "max_retention_days": 1,
      "max_sites_per_team": 1,
      "max_team_members": 1
    },
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "logo_url": "example",
    "name": "example",
    "plan": {
      "code": "example",
      "name": "example",
      "support_url": "example",
      "upgrade_url": "example"
    },
    "role": "example",
    "usage": {
      "current_members": 1,
      "current_pending_invites": 1,
      "current_sites": 1
    }
  }
}
```

### 400

Invalid request

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

### 403

Team limit reached

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

[Previous List teams](https://hitkeep.com/api/operations/apiuserteams/get/)[Next Set active team](https://hitkeep.com/api/operations/apiuserteamsactive/)