---
title: "Create team membership"
method: POST
path: "/teams/{team_id}/memberships"
tags: ["teams"]
---

# Create team membership

`POST /teams/{team_id}/memberships`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/teams/{team_id}/memberships`
- Auth: HTTP bearer

Create team membership for the given user, role, and team

## Path parameters

- `team_id` string, required

## Request body

- MembershipCreate
  - `role` 'ADMIN' | 'MEMBER'
  - `userId` string

## Response `201`

Created

- Membership
  - `role` 'ADMIN' | 'MEMBER'
  - `user` UserSummary
    - `handle` string
    - `id` string
    - `name` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)
