---
title: "Create a team"
method: POST
path: "/v2/teams"
tags: ["B2B Teams"]
---

# Create a team

`POST /v2/teams`

## Request body

- object
  - `name` string, required — Name of the team, must be at least 1 character long and trimmed
  - `company_nanoid` string, required — Unique identifier for the company in nanoid format
  - `admins` object[], required
    - `nanoid` string, required — Unique identifier for the admin user in nanoid format
    - `type` 'team_admin' | 'team_finance_admin' | 'team_viewer', required — Role type of the admin within the team, can be team_admin, team_finance_admin, or team_viewer
  - `avatar_file_name` string — Optional filename for the team avatar
  - `withdraw_fee_coverage` boolean, required — Indicates whether the team covers withdrawal fees

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `name` string, required — Name of the team.
    - `nanoid` string, required — Unique identifier for the team.
    - `avatar` string, required — URL of the team avatar.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy.md) · [All operations](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/riseworks/b2b-api-v1-legacy/versions/6f6941749255/schema)