---
title: "Create a member"
method: POST
path: "/v2/members"
tags: ["Members"]
---

# Create a member

`POST /v2/members`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/members`
- Auth: HTTP bearer

Create a user.

  ### Usage notes
  - Creating a user with this endpoint sends an email invitation to the user. Embed users are not sent email invitations.
  - Review the account types returned by the [/v2/members](https://help.sigmacomputing.com/reference/list-members) endpoint to understand the format of the **memberType** string.
  - If **memberType** is omitted, the organization's Invitation default account type (configured in Admin > Account types) is used. If no Invitation default is configured, a built-in default account type is used.
  - Retrieve the **teamId**(s) by calling the [/v2/teams](https://help.sigmacomputing.com/reference/list-teams) endpoints.

## Query parameters

- `sendInvite` boolean

## Request body

- object
  - `email` string, email, required
  - `firstName` string, required
  - `lastName` string, required
  - `language` 'DE_DE' | 'EN' | 'EN_AU' | 'EN_CA' | 'EN_GB' | 'EN_IE' | 'ES_ES' | 'ES_MX' | 'FR_CA' | 'FR_FR' | 'IT_IT' | 'JA_JA' | 'KO_KR' | 'NL_NL' | 'PL_PL' | 'PT_BR' | 'PT_PT' | 'RU_RU' | 'SV_SE' | 'TH_TH' | 'TR_TR' | 'ZH_CN' | 'ZH_TW': The user's preferred display language. (Beta)
  - `formatRegion` 'AU' | 'BR' | 'CA' | 'CN' | 'DE' | 'ES' | 'FR' | 'GB' | 'IE' | 'IT' | 'JP' | 'KR' | 'MX' | 'NL' | 'PL' | 'PT' | 'RU' | 'SE' | 'TH' | 'TR' | 'TW' | 'US': Controls number, date, and currency formatting for the user, following the conventions of the specified region. (Beta)
  - `memberType` string: Account type
  - `isGuest` boolean
  - `userKind` 'internal' | 'guest' | 'embed'
  - `addToTeams` V2MembersPostRequestBodyContentApplicationJsonSchemaAddToTeamsItems[]: Add user to one or more teams.
    - `teamId` string, required
    - `isTeamAdmin` boolean

## Response `200`

The response body.

- MembersCreateMemberResponse200
  - `organizationId` string, required
  - `memberId` string, required
  - `memberType` string, required
  - `firstName` string, required
  - `lastName` string, required
  - `email` string, required
  - `profileImgUrl` string, nullable, required
  - `createdBy` string, required
  - `updatedBy` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `homeFolderId` string, required: ID of the My Documents folder for the user
  - `userKind` string, required
  - `language` 'DE_DE' | 'EN' | 'EN_AU' | 'EN_CA' | 'EN_GB' | 'EN_IE' | 'ES_ES' | 'ES_MX' | 'FR_CA' | 'FR_FR' | 'IT_IT' | 'JA_JA' | 'KO_KR' | 'NL_NL' | 'PL_PL' | 'PT_BR' | 'PT_PT' | 'RU_RU' | 'SV_SE' | 'TH_TH' | 'TR_TR' | 'ZH_CN' | 'ZH_TW': The user's preferred display language. (Beta)
  - `formatRegion` 'AU' | 'BR' | 'CA' | 'CN' | 'DE' | 'ES' | 'FR' | 'GB' | 'IE' | 'IT' | 'JP' | 'KR' | 'MX' | 'NL' | 'PL' | 'PT' | 'RU' | 'SE' | 'TH' | 'TR' | 'TW' | 'US': Controls number, date, and currency formatting for the user, following the conventions of the specified region. (Beta)
  - `isArchived` boolean: Whether a user is deactivated in Sigma.
  - `isInactive` boolean: Whether a user is archived by SCIM.

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)