---
title: "Add Account Members"
method: POST
path: "/identity/account-members"
tags: ["Account Members"]
---

# Add Account Members

`POST /identity/account-members`

Add one or more account members to a given account.

The account members added by this API do not affect existing account members. For example,
if an account has two members, and one member is added using this API, then the account will
end up with three members.

For more information on properties of account members, see [Account Members](#account-members).

## Request body

- AddAccountMembersRequest
  - `account_id` string, required — ID of account to which members will be added.
  - `members` AccountMember[], required — A non-empty array of account members to be added. Account members allow additional identities to act on this account (e.g. joint accounts).
    - `identity_id` string, required
    - `type` 'BENEFICIAL_OWNER' | 'AUTHORIZED_USER' | 'FINANCIAL_ADVISOR'
    - `roles` AccountMemberAccountRoleType[]
    - `id` string — Account member ID. Note: This field is auto-generated. Specifying an ID when creating an account member is a client error.

## Response `200`

A successful response.

- AddAccountMembersResponse
  - `account_id` string, required — ID of account to which members were added.
  - `members` AccountMember[] — List of account members that were added to the account.
    - `identity_id` string, required
    - `type` 'BENEFICIAL_OWNER' | 'AUTHORIZED_USER' | 'FINANCIAL_ADVISOR'
    - `roles` AccountMemberAccountRoleType[]
    - `id` string — Account member ID. Note: This field is auto-generated. Specifying an ID when creating an account 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)