Create Team Member

Adds a member to an account’s team with a system role. Identify them by exactly one of user_id or email. If the person has not yet accepted — or the email does not belong to a Whop account yet — an invitation is sent instead and the response is 202 with { "object": "team_member_invite", "invitation_sent": true }. If they already have a pending invite, the request fails with a 400. Custom roles cannot be granted via the API. Granting the workforce role is also allowed with the bounty:create scope.

POST /team_members

JavaScript

JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

const teamMember = await client.teamMembers.create({
  account_id: 'biz_xxxxxxxxxxxxxx',
  role: 'sales_manager',
});

console.log(teamMember.id);

201

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "authorized_role": {
    "id": "<string>",
    "name": "<string>"
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "email": "[e-mail]",
  "id": "ausr_xxxxxxxxxxxxxx",
  "is_agent": false,
  "role": "moderator",
  "status": "joined",
  "updated_at": "2026-01-01T12:00:00.000Z",
  "user": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Dana Whitfield",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "danawhitfield"
  }
}

Authorizations

Authorization · string · header · required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Idempotency-Key · string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255

Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date · string

Pins the request to a dated API version.

Example:

"2026-08-21"

Body

application/json

account_id · string · required

Account ID, prefixed biz_.

Example:

"biz_xxxxxxxxxxxxxx"

role · enum<string> · required

The system role to grant.

Available options: owner, admin, sales_manager, moderator, advertiser, workforce

Example:

"sales_manager"

email · string

Email address to invite. Mutually exclusive with user_id. If the email already belongs to a Whop account it is treated the same as passing that account's user_id; otherwise a pending invite is created for the email.

Example:

"[e-mail]"

user_id · string

The user to add to the team, prefixed user_. Mutually exclusive with email.

Example:

"user_xxxxxxxxxxxxxx"

Response

201

application/json

Team member created.

account_id · string · required

The account this membership belongs to, prefixed biz_.

Example:

"biz_xxxxxxxxxxxxxx"

authorized_role · object | null · required

Custom role assigned to this member, or null when the member has a system role.

Show child attributes

created_at · string · required

When the member joined or the invite was sent, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

email · string | null · required

The member's email address. For accepted members, null unless the caller holds the email read scope; for invites, the invited address.

Example:

"[e-mail]"

id · string · required

Team member ID — ausr_ for accepted members, ausri_ for pending invites.

Example:

"ausr_xxxxxxxxxxxxxx"

is_agent · boolean · required

Whether this member is an agent (app-controlled account) rather than a human team member. Always false for invites.

Example:

false

role · enum<string> · required

The member's role on the account. custom means a bespoke dashboard-managed role; the API can read but not grant it.

Available options: owner, admin, sales_manager, moderator, advertiser, app_manager, support, manager, workforce, custom

Example:

"moderator"

status · enum<string> · required

joined for accepted members, pending while the invite is pending.

Available options: joined, pending

Example:

"joined"

updated_at · string · required

When the membership was last updated, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

user · object | null · required

The user behind this team membership. null for an invite sent to an email with no Whop account yet.

Show child attributes