---
title: "Adds a Team"
method: POST
path: "/Teams"
tags: ["Teams"]
---

# Adds a Team

`POST /Teams`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Teams`
- Auth: none declared. Required headers: `Authorization`

TEAM_NAME is required when creating a Team with ANONYMOUS_TEAM set to "false". When creating Anonymous Teams, e.g. ANONYMOUS_TEAM=true, you must include all the Team Members that should be part of the team. A minimum of one Team Member is required.             For more details, please refer to GET /Teams above.

## Headers

- `Authorization` string, required

## Request body

- APITeam
  - `TEAM_ID` integer
  - `TEAM_NAME` string
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `TEAMMEMBERS` APITeamMember[]
    - `PERMISSION_ID` integer
    - `TEAM_ID` integer
    - `MEMBER_USER_ID` integer, required

## Response `201`

Team added.

- object
  - `TEAM_ID` integer
  - `TEAM_NAME` string
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `TEAMMEMBERS` APITeamMember[]
    - `PERMISSION_ID` integer
    - `TEAM_ID` integer
    - `MEMBER_USER_ID` integer, required

## Other responses

- `400`: Data validation error.
- `401`: Invalid api key provided.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)