---
title: "Add a member"
method: POST
path: "/accounts/{id}/members"
tags: ["Account Members"]
---

# Add a member

`POST /accounts/{id}/members`

Adds a member to an account

## Path parameters

- `id` string, uuid, required — The target account ID

## Request body

- AccountMemberPayloadArray
  - `members` AccountMemberPayload[], required — An array of objects, each representing a member to add to an account
    - `firstName` string — Required if name is not set.
    - `lastName` string — Required if name is not set.
    - `name` string — Either firstName and lastName, or name must be supplied, but never all three.
    - `email` string, required
  - `message` union — This parameter allows you to send a custom message. It can be set to one of the following options: 1. string - Sends a Safebase email with a custom message attached 2. boolean - Set this parameter to 'true' to send a SafeBase email without any custom message 3. undefined - If you do not wish to send a Safebase email, simply do not send this property as part of your request
    - string — Enter the 'string' option here
    - boolean — Enter the 'boolean' option here

## Response `201`

Successful operation

- object
  - `ok` boolean
  - `result` AccountMemberResponse[]
    - `accountId` string
    - `firstName` string
    - `lastName` string
    - `name` string
    - `email` string
    - `createdAt` string, date-time
    - `lastSeen` string, date-time, nullable

## Other responses

- `400` — Invalid request
- `403` — Invalid api key / missing scope
- `404` — Not found or no access
- `405` — Method not allowed

---

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