---
title: "Create organization member"
method: POST
path: "/organizations/{organization_id}/members"
tags: ["Organization Members"]
---

# Create organization member

`POST /organizations/{organization_id}/members`

Creates a new organization member.

## Path parameters

- `organization_id` string, ulid, required

## Request body

- object
  - `user_id` string, uuid, required — ID of the user.
  - `permissions` string[] — The organization member permissions.

## Response `201`

Created

- OrganizationMember
  - `id` string, uuid — The ID of the user.
  - `organization_id` string, ulid — The ID of the organization.
  - `user_id` string, uuid — The ID of the user.
  - `permissions` string[] — The organization member permissions.
  - `level` 'admin' | 'viewer' — Access level of the member.
  - `owner` boolean — Whether the member is the organization owner.
  - `created_at` string, date-time — The date and time when the member was created.
  - `updated_at` string, date-time — The date and time when the member was last updated.
  - `_links` object
    - `self` object — Link to the current member.
      - `href` string — URL of the link.
    - `update` object — Link for updating the current member.
      - `href` string — URL of the link.
      - `method` string — The HTTP method to use.
    - `delete` object — Link for deleting the current member.
      - `href` string — URL of the link.
      - `method` string — The HTTP method to use.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)