---
title: "Adds a user to a specified workspace as a member."
method: POST
path: "/workspaces/{workspace_id}/members"
tags: ["workspaces"]
---

# Adds a user to a specified workspace as a member.

`POST /workspaces/{workspace_id}/members`

You can add user only from the contract, which current workspace belongs to. A notification email will be sent. The user becomes a member immediately. You need `workspaces.workspace.edit` or `tenant.workspace.edit_membership` permissions to access this resource

## Path parameters

- `workspace_id` string, required

## Request body

- object
  - `data` object, required
    - `id` string, required — ID of an already registered user, who will be added as a member of the Workspace
    - `type` 'member', required — Allowed value “member”.
    - `attributes` object, required
      - `roles` string[], required

## Response `200`

OK

- object
  - `data` object, required
    - `id` string, required
    - `type` 'member', required
    - `links` object, required
      - `self` string, required
    - `attributes` object, required
      - `first_name` string, required
      - `last_name` string, required
      - `roles` string[], required
      - `email` string, required
  - `meta` object, required

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)