---
title: "Create a space membership"
method: POST
path: "/{account}/spaces/{space}/memberships"
---

# Create a space membership

`POST /{account}/spaces/{space}/memberships`

## Request

- Base URL: `https://modeanalytics.com/api`
- URL: `https://modeanalytics.com/api/{account}/spaces/{space}/memberships`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/thoughtspot/apis/mode/docs/:account/spaces/:space/memberships/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns all `Memberships` for a `Space`

## Path parameters

- `account` string, required
- `space` string, required

## Request body

- CreateSpaceMembershipRequestBody
  - `membership` object, required: The attributes of the new member being added to the space
    - `member_type` string, required: The type of member, either `"User"` or `"UserGroup"`
    - `member_token` string, required: The token of the member being added

## Response `200`

`SpaceMembership` response

- SpaceMembership
  - `token` string, required
  - `member_token` string, required
  - `member_type` string, required
  - `member_id` string, required
  - `email` string
  - `_links` SpaceMembershipLinks, required
    - `self` Link, required
      - `href` string, required
      - `templated` boolean
    - `member` Link, required
      - `href` string, required
      - `templated` boolean
    - `creator` Link
      - `href` string, required
      - `templated` boolean
  - `_embedded` unknown

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: `Space` not found

---

[API](https://skmtc.dev/thoughtspot/apis/mode.md) - [All operations](https://skmtc.dev/thoughtspot/apis/mode/llms.txt) - [OpenAPI document](https://skmtc.dev/thoughtspot/apis/mode/revisions/4c694c3fdeb1?raw)