---
title: "Create Team"
method: POST
path: "/team"
---

# Create Team

`POST /team`

## Request body

- object
  - `team` object
    - `team_name` string
    - `custom_fields` object[]
      - `label` string, required
      - `value` string, required
      - `type` string, required
      - `ref_uid` string
      - `module_name` 'JOB' | 'CUSTOMER' | 'EMPLOYEE' | 'ESTIMATE' | 'INVOICE' | 'PRODUCT' | 'PURCHASE_ORDER' | 'SERVICE_CONTRACT' | 'ASSET' | 'PROPERTY' | 'ORGANIZATION' | 'TEAM' | 'REQUEST' | 'PROJECT'
      - `hide_to_fe` boolean
      - `hide_field` boolean
      - `read_only` boolean
      - `group_name` string
      - `group_uid` string
    - `team_timezone` string
    - `is_dispatchable` boolean
    - `team_color` string
    - `business_unit` string[] — Array of Trade type UIDs (upto 25 trade types)
  - `user_uid` string
  - `user_uids` string[]

## Response `200`

200

- object
  - `type` string
  - `title` string
  - `message` string
  - `data` object
    - `team_uid` string

## Other responses

- `400` — 400
- `500` — 500

---

[API](https://skmtc.net/zuper/apis/zuper-pro-api.md) · [All operations](https://skmtc.net/zuper/apis/zuper-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuper/zuper-pro-api/revisions/c7b8028a05de/schema)