---
title: "Add organization team member"
method: POST
path: "/v1/organizations/{organizationRef}/teams/{team_id}/members"
tags: ["Organization", "Team", "User"]
---

# Add organization team member

`POST /v1/organizations/{organizationRef}/teams/{team_id}/members`

## Request

- Base URL: `https://example.com/api`
- URL: `https://example.com/api/v1/organizations/{organizationRef}/teams/{team_id}/members`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`; client credentials, token URL `/oauth/token`; password, token URL `/oauth/token`, scopes: `organization`)

Add an existing user to an organization's team.

## Request body

- object
  - `user_id` string, required: ID of the user to add.

## Response `201`

Example response

- object
  - `id` string, required: ID of the newly created resource.

## Other responses

- `400`: Bad request
- `401`: Unauthorized request
- `403`: Forbidden
- `404`: The requested resource not found
- `409`: Conflict
- `500`: Internal Server Error

## Changes

- **2026-10-16** `8a34c0b5508e`: 6 info
  - added the non-success response with the status `409`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - …2 more

[Operation history](https://skmtc.dev/opcotech/apis/elemo-api/changes/v1/organizations/:organizationRef/teams/:team_id/members/post.md)

---

[API](https://skmtc.dev/opcotech/apis/elemo-api.md) · [All operations](https://skmtc.dev/opcotech/apis/elemo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/opcotech/apis/elemo-api/revisions/12e233bb333e?raw)