Sign inGet Started

Add a member to a ring group

POST
/v1/voice/ring-groups/{ring_group_id}/members
const member = await bird.voice.ringGroups.members.create("RING_GROUP_ID", { user_id: "USER_ID" });
console.log(member.user_id);
响应201
{
  "user_id": "usr_01krdgeqcxet5s7t44vh8rt9mg",
  "created_at": "2026-10-01T12:00:00Z"
}

Adds a workspace user to the ring group. The group rings the user only while they are online in the browser phone.

A user without access to the workspace returns 422, as does adding a member to a group that already has 200. Adding a user who is already a member, or adding to the default group, returns 409 Conflict.

参数

ring_group_idstring

ID of the ring group whose members to list or add to.

请求载荷

user_id
string
必填

The workspace user to add. bird members list and the members_list MCP tool list workspace members in pages, each with its user.id; follow next_cursor until the user appears. Both need the members scope at read level.

响应载荷

user_id
string
必填

The member's user ID.

created_at
nullable string
必填

When the user joined the ring group. Null for the default group, whose members are the users online now.