---
title: "Creating a new Organization Membership"
method: POST
path: "/organization_memberships"
tags: ["Organization Memberships"]
---

# Creating a new Organization Membership

`POST /organization_memberships`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/organization_memberships`
- Auth: none declared

Applies an organization to a workspace (project) or user.

**Bulk Create**

This endpoint supports bulk creating up to 100 objects. In the request body, set the top-level key to its plural form and place the objects in an array. Example:

```
{
  "organization_memberships": [
    {
      "geography_id": 123,
      "department_id": 456,
      "member_id": 111,
      "member_type": "User"
    },
    {
      "geography_id": 123,
      "department_id": 456,
      "member_id": 222,
      "member_type": "User"
    }
  ]
}
```


This endpoint returns structured Organization Membership objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `organization_memberships` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `include` string
- `optional_fields` string[]

## Request body

- object
  - `organization_membership` object
    - `geography_id` integer, required: The ID of the membership's geography.
    - `department_id` integer, required: The ID of the membership's department.
    - `member_id` integer, required: The ID of the project or user.
    - `member_type` string, required: The type of object that describes the member (workspace or user).

## Response `200`

Organization Membership has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `organization_memberships` object
  - `organizations` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)