---
title: "Add Institution Members"
method: POST
path: "/identity/institution-members"
tags: ["Institution Members"]
---

# Add Institution Members

`POST /identity/institution-members`

Add one or more institution members to a given institution.

Adding new members doesn't affect existing members. For example, if an institution has three
members, and adds two members using this API, then the institution would end up with five total members.

For details on the properties that can be specified when creating institution members,
see [Specifying Institution Members and Their Roles](#specifying-institution-members-and-their-roles).

## Request body

- AddInstitutionMembersRequest
  - `institution_id` string, required — ID of institution identity to which members will be added.
  - `members` InstitutionMember[], required — A non-empty array of institution members that were added. Should always be present in practice.
    - `identity_id` string, required
    - `roles` InstitutionRoleType[] — The role(s) the member fulfils for the institution. Should always be present in practice. See the [developer guide](https://docs.paxos.com/guides/identity/institution-types) for required roles per institution type.
    - `ownership` string, decimal — Decimal number representing the percent ownership the identity has in the company-- e.g. 5 represents 5% ownership.
    - `position` string
    - `name` string
    - `summary_status` 'PENDING' | 'ERROR' | 'APPROVED' | 'DENIED' | 'DISABLED'
    - `id` string — Institution member ID. Note: This field is auto-generated. Specifying an ID when creating an institution member is a client error.

## Response `200`

A successful response.

- AddInstitutionMembersResponse
  - `institution_id` string, required — ID of institution identity to which members were added.
  - `members` InstitutionMember[] — List of institution members that were added to the institution.
    - `identity_id` string, required
    - `roles` InstitutionRoleType[] — The role(s) the member fulfils for the institution. Should always be present in practice. See the [developer guide](https://docs.paxos.com/guides/identity/institution-types) for required roles per institution type.
    - `ownership` string, decimal — Decimal number representing the percent ownership the identity has in the company-- e.g. 5 represents 5% ownership.
    - `position` string
    - `name` string
    - `summary_status` 'PENDING' | 'ERROR' | 'APPROVED' | 'DENIED' | 'DISABLED'
    - `id` string — Institution member ID. Note: This field is auto-generated. Specifying an ID when creating an institution member is a client error.

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/revisions/0687ca8c9a8d/schema)