---
title: "POST /v1/project-members/"
method: POST
path: "/v1/project-members/"
tags: ["project-members"]
---

# POST /v1/project-members/

`POST /v1/project-members/`

## Request body

- object
  - `projectId` string, required
  - `email` string, required
  - `role` union, required
    - 'ADMIN'
    - 'EDITOR'
    - 'VIEWER'
  - `status` union
    - 'ACTIVE'
    - 'PENDING'

## Response `201`

Project member is which user is assigned to a project.

- object — Project member is which user is assigned to a project.
  - `id` string, required
  - `created` string, required
  - `updated` string, required
  - `email` string, required
  - `platformId` string, nullable
  - `projectId` string, required
  - `role` union, required
    - 'ADMIN'
    - 'EDITOR'
    - 'VIEWER'
  - `status` union, required
    - 'ACTIVE'
    - 'PENDING'

## Changes

- **2023-12-17** `e4e2ec56a169` — 1 breaking
  - the response property `platformId` became optional for the status `201`
- **2023-12-09** `8a2f0946c574` — 1 breaking
  - added the new required request property `projectId`
- **2023-12-06** `c5ff28051098` — 1 info
  - endpoint added
- **2023-12-03** `7b0cc60eed56` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/tookey-io/apis/activepieces-documentation/changes/v1/project-members/post.md)

---

[API](https://skmtc.dev/tookey-io/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/tookey-io/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tookey-io/activepieces-documentation/revisions/47ba6f96910d/schema)