---
title: "Adds a new member to a project."
method: POST
path: "/v1/projects/{idOrName}/members"
tags: ["projectMembers"]
---

# Adds a new member to a project.

`POST /v1/projects/{idOrName}/members`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/projects/{idOrName}/members`
- Auth: HTTP bearer

Adds a new member to the project.

## Path parameters

- `idOrName` string, required: The ID or name of the Project.

## Query parameters

- `teamId` string
- `slug` string

## Request body

- union
  - object
    - `uid` string, required: The ID of the team member that should be added to this project.
    - `username` string: The username of the team member that should be added to this project.
    - `email` string, email: The email of the team member that should be added to this project.
    - `role` 'ADMIN' | 'PROJECT_VIEWER' | 'PROJECT_DEVELOPER', required: The project role of the member that will be added.
  - object
    - `uid` string: The ID of the team member that should be added to this project.
    - `username` string, required: The username of the team member that should be added to this project.
    - `email` string, email: The email of the team member that should be added to this project.
    - `role` 'ADMIN' | 'PROJECT_VIEWER' | 'PROJECT_DEVELOPER', required: The project role of the member that will be added.
  - object
    - `uid` string: The ID of the team member that should be added to this project.
    - `username` string: The username of the team member that should be added to this project.
    - `email` string, email, required: The email of the team member that should be added to this project.
    - `role` 'ADMIN' | 'PROJECT_VIEWER' | 'PROJECT_DEVELOPER', required: The project role of the member that will be added.

## Response `200`

Responds with the project ID on success.

- object: Responds with the project ID on success.
  - `id` string, required

## Other responses

- `400`: One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `500`

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-01-22** `c12186034433`: 1 breaking
  - request body became required
- **2025-03-19** `37b482c58c92`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/projects/:idOrName/members/post.md)

---

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