---
title: "Add members to a topic"
method: POST
path: "/v2/topics/{topicId}/members"
tags: ["Topics (group chats/channels/conversations)"]
---

# Add members to a topic

`POST /v2/topics/{topicId}/members`

## Request

- Base URL: `https://api.zenzap.co`
- URL: `https://api.zenzap.co/v2/topics/{topicId}/members`
- Auth: one of:
  - HTTP bearer and API key in header `X-Signature`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.zenzap.co/oauth/token` scopes: `channel:write`
- TypeScript: <https://skmtc.dev/zenzap/apis/zenzap-external-integration-api/docs/v2/topics/:topicId/members/post.ts> (a function with typed inputs; its response is checked against the schema)

Add one or more members to an existing topic.

**Authorization:** Your API key bot must be a member of the topic (returns 404 if not).

**Validation:**
- All members being added must exist and be from the same organization as the bot (returns 400 "Invalid member" if not)
- Members already in the topic will result in a 400 error

**Limits:** Maximum 5 members per request. Duplicate member IDs in the request are automatically removed. For adding many members, create the topic with all members upfront.

## Path parameters

- `topicId` string, uuid, required

## Headers

- `X-Signature` string
- `X-Timestamp` integer

## Request body

- TopicMemberAddRequest
  - `memberIds` string[], required: Array of member IDs to add to the topic (max 5). All members must be from the same organization as the bot and must not already be members of the topic. Duplicate IDs in the request are automatically removed.

## Response `200`

Members added successfully

- TopicMemberUpdateResponse
  - `id` string, uuid: The topic ID
  - `memberIds` string[]: Updated array of member IDs in the topic
  - `updatedAt` integer: Unix timestamp in milliseconds when the topic was updated

## Other responses

- `400`: Bad request - invalid input
- `401`: Unauthorized - invalid or missing API token
- `404`: Resource not found
- `500`: Internal server error

---

[API](https://skmtc.dev/zenzap/apis/zenzap-external-integration-api.md) - [All operations](https://skmtc.dev/zenzap/apis/zenzap-external-integration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zenzap/apis/zenzap-external-integration-api/revisions/37faae2c2036?raw)