Create Team Member
Adds a user to an account’s team with a system role. If the user has not yet accepted, an invitation is sent instead and the response is 202 with { "object": "team_member_invite", "invitation_sent": true }. If the user already has a pending invite, the request fails with a 400. Custom roles cannot be granted via the API.
Authorizations
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-07-20"
Body
Response
Team member created.
The account this membership belongs to, prefixed biz_.
When the member joined or the invite was sent, as an ISO 8601 timestamp.
The member's email address. For accepted members, null unless the caller holds the email read scope; for invites, the invited address.
Team member ID — ausr_ for accepted members, ausri_ for pending invites.
Whether this member is an agent (app-controlled account) rather than a human team member. Always false for invites.
The member's role on the account. custom means a bespoke dashboard-managed role; the API can read but not grant it.
owner, admin, sales_manager, moderator, advertiser, app_manager, support, manager, custom "owner"
joined for accepted members, pending while the invite is pending.
joined, pending "joined"
When the membership was last updated, as an ISO 8601 timestamp.
The user behind this team membership. null for an invite sent to an email with no Whop account yet.

