Create team

POST

/api/user/teams

curl --request POST \
  --url https://hitkeep.com/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

Request Body ^required

Media type application/json

object

logo_url

string

name

required

string

Example ^generated

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

Responses

201

Created team

Media type application/json

object

team

object

created_at

string format: date-time

entitlements

object

allow_custom_branding

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

Example ^generated

{
  "team": {
    "created_at": "2026-04-15T12:00:00Z",
    "entitlements": {
      "allow_custom_branding": 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

Media type application/json

object

message

string

Example ^generated

{
  "message": "example"
}

403

Team limit reached

Media type application/json

object

message

string

Example ^generated

{
  "message": "example"
}