---
title: "Add embed group members"
method: POST
path: "/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users"
tags: ["Embed Tenants"]
---

# Add embed group members

`POST /api/v1/embed-tenants/{embedTenantName}/groups/{id}/users`

## Path parameters

- `embedTenantName` string, required
- `id` integer, required

## Request body

- EmbedGroupMembersInput
  - `members` EmbedGroupMemberInput[], required — Embed users to add or remove (1–1000 per request).
    - `embedUserId` integer, nullable — Numeric id of an existing embed user. Provide this OR `externalId`.
    - `externalId` string, nullable — External id of the embed user (the `externalId` passed to `generate-session`). Provide this OR `embedUserId`.

## Response `200`

- EmbedGroupMembersMutationResponse
  - `addedMembers` EmbedUser[], required
    - `createdAt` union
      - string, date
      - string, date-time
    - `email` string, nullable
    - `externalId` string, nullable
    - `firstName` string, nullable
    - `id` integer, required
    - `lastLogin` union
      - string, date
      - string, date-time
    - `username` string, required
  - `unchangedMembers` EmbedUser[], required
    - `createdAt` union
      - string, date
      - string, date-time
    - `email` string, nullable
    - `externalId` string, nullable
    - `firstName` string, nullable
    - `id` integer, required
    - `lastLogin` union
      - string, date
      - string, date-time
    - `username` string, required

---

[API](https://skmtc.net/cube-js/apis/cube-cloud-rest-api.md) · [All operations](https://skmtc.net/cube-js/apis/cube-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cube-js/cube-cloud-rest-api/revisions/a0c6b1d2ac96/schema)