---
title: "Team member creation"
method: POST
path: "/teams/{team_id}/members/"
tags: ["Teams"]
---

# Team member creation

`POST /teams/{team_id}/members/`

## Request

- Base URL: `http://api.cannoli.app/api/v1`
- URL: `http://api.cannoli.app/api/v1/teams/{team_id}/members/`
- Auth: none declared

### Permissions
Here you can create new members for a given team.

The optional permission field sets the user's access to a team's files:
* R: Read
* W: Write
* A: Admin

If no permission is assiged on creation the default value is 'R'.

### Multiple TeamMember creation
You can optionally send the TeamMember creation JSON as a list to create multiple members at once:

    [{"email": "user@example.com"}, {"email": "user2@example.com"}]

## Request body

- AddTeamMember
  - `email` string, email, required
  - `team` integer
  - `user` integer
  - `permission` 'R' | 'W' | 'A'

## Response `201`

Created

- AddTeamMember
  - `email` string, email, required
  - `team` integer
  - `user` integer
  - `permission` 'R' | 'W' | 'A'

---

[API](https://skmtc.dev/cannoli/apis/cannoli-backend-api.md) - [All operations](https://skmtc.dev/cannoli/apis/cannoli-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cannoli/apis/cannoli-backend-api/revisions/d27aef14fd7a?raw)