Add a member

Adds an existing BazaarLink user (looked up by email) to the given organization. This endpoint **does not create a new account or send an invitation email** — the person must already have a BazaarLink account, or the request returns 404. role defaults to member when omitted; valid values are org_admin, billing_viewer, team_admin, and member. Only an org_admin of that organization may call this.

POST/api/v1/orgs/:orgId/members

Authorizations

Authorizationrequired

string · header

API key as bearer token in the Authorization header.

Path parameters

orgIdrequired

string

The organization ID, from a GET /orgs response.

Body

emailrequired

string

The email of the user to add, matched case-insensitively with whitespace trimmed.

role

string

The member's role, defaults to member when omitted.

org_adminbilling_viewerteam_adminmember

Example: "member"

teamId

string | null

Assigns the member to a given team (from a list-teams response); omitted or null means no team assignment.

monthlyBudget

number | null

Optional monthly budget figure in USD, with no range validation.

POST /api/v1/orgs/:orgId/members

1
2
3
4
curl -X POST https://bazaarlink.ai/api/v1/orgs/org_abc123/members \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com", "role": "member", "teamId": "team_abc123"}'

Response examples

Added.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "member": {
    "id": "orgmem_abc123",
    "role": "member",
    "monthlyBudget": null,
    "joinedAt": "2026-07-27T00:00:00.000Z",
    "teamId": "team_abc123",
    "user": {
      "id": "usr_xyz789",
      "name": "Jane Doe",
      "email": "jane@acme.com"
    },
    "team": {
      "id": "team_abc123",
      "name": "Engineering"
    }
  }
}