Members API Reference

List organization members to resolve emails to user IDs when managing schedules.

List Members

SDK

client.member.list()

List all members in your organization.

Returns: Promise<OrganizationMember[]>

Example:

const members = await client.member.list();

client.member.listSafe()

List members without throwing exceptions.

Returns: Promise<Result<OrganizationMember[]>>

Example:

const result = await client.member.listSafe();

if (result.error) {
  console.error("Error:", result.error.message);
} else {
  console.log(`Members: ${result.data.length}`);
}

API

HTTP Endpoint

GET /v0/members

All API requests require authentication using your access token:

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://api.beeps.dev/v0/members

CLI

beeps member list

Add --json for machine-readable output:

beeps member list --json

MCP

Tool: beeps_list_members

{}

Types

OrganizationMember

type OrganizationMember = {
  userId: string;
  organizationId: string;
  role: string;
  email: string;
};