---
title: "Add Member to Workspace"
method: POST
path: "/public/v1/workspaces/{workspace_id}/members"
tags: ["User and Workspace management"]
---

# Add Member to Workspace

`POST /public/v1/workspaces/{workspace_id}/members`

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v1/workspaces/{workspace_id}/members`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.pandadoc.com/oauth2/authorize`
    - Token URL: `https://api.pandadoc.com/oauth2/access_token`
- TypeScript: <https://skmtc.dev/pandadoc/apis/pandadoc-public-api/docs/public/v1/workspaces/:workspace_id/members/post.ts> (a function with typed inputs; its response is checked against the schema)

Add an existing user to a workspace.
- You must be an organization admin or a workspace admin to add members.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `notify_user` boolean
- `notify_ws_admins` boolean

## Request body

- AddMemberRequest
  - `user_id` string, required: User id.
  - `role` 'Admin' | 'Manager' | 'Member' | 'Collaborator', required: Role for a member.

## Response `201`

OK

- AddMemberResponse
  - `member_id` string
  - `workspace_id` string
  - `role` 'Admin' | 'Manager' | 'Member' | 'Collaborator': Role for a member.
  - `email` string
  - `first_name` string
  - `last_name` string

## Other responses

- `400`: Bad Request
- `401`: Authentication error
- `403`: Permission error
- `404`: Not found
- `429`: Too Many Requests

---

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