---
title: "Add a project team member"
method: POST
path: "/projects/{project-id}/members"
tags: ["Projects"]
---

# Add a project team member

`POST /projects/{project-id}/members`

## Request

- Base URL: `https://projects-api.home.mendix.com/v2`
- URL: `https://projects-api.home.mendix.com/v2/projects/{project-id}/members`
- Auth: API key in header `Authorization`

Adds a team member to the project with a specific role or sends an invitation if the member is not from the same organization as the project. The user must be an active member of the platform. If the organization of the member is not yet using centralized project roles, only the Scrum Master role can be assigned.</br></br>If the invited user is from the same organization as the project, the server responds with a `201`. If an invitation was sent, the server responds with a `202`. In the latter case the invited user must first accept the invitation before becoming a team member.</br></br>Every request must be authenticated by a Personal Access Token containing the scope `mx:app:team:write`.

## Path parameters

- `project-id` string, required

## Request body

- object
  - `memberId` string: Unique identifier of the member
  - `roleId` string: The unique identifier of the role that will be assigned to the member.

## Response `201`

Created

## Other responses

- `202`: Accepted
- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/mendix/apis/projects-api.md) - [All operations](https://skmtc.dev/mendix/apis/projects-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/projects-api/revisions/3a958ca32c74?raw)