Create Member
Adds a person to an account as a member. If the person is already a member of the account, that member is returned unchanged.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Scopes
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-11-12"
Body
The email address of the person to add. If no Whop user has it, one is created.
"jane@example.com"
The account to add the member to (biz_ tag). Defaults to the account the credential acts as.
"biz_xxxxxxxxxxxxxx"
The name of the person to add. Ignored when a user on Whop already exists for this email address.
"Jane Doe"
Response
member created for an email with no Whop user
What the member can reach on the account: customer for paying members, admin for team members, no_access once every grant has lapsed.
no_access, admin, customer "customer"
The account this member belongs to, prefixed biz_.
"biz_xxxxxxxxxxxxxx"
When the member record was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
The name to show for this member: the user's name, or their username when they have not set one. The buying business's name when user is null.
"Dana Whitfield"
The user's gross income across Whop, in USD, refreshed periodically. null when the user hides their earnings or the buyer is another business.
The user's email address. null without member:email:read on the account, when the buyer is another business, or when the user has no assigned email.
"marcus@shinetime.example"
Member ID, prefixed mber_.
"mber_xxxxxxxxxxxxxx"
When the member first joined the account, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
When the member last opened the account's content, as an ISO 8601 timestamp. null if they never have.
"2026-01-01T12:00:00.000Z"
What happened at last_activity_at. object says which kind of activity it is. null without support_chat:read on the account, or when last_activity_at is null.
When the member and the account last interacted, as an ISO 8601 timestamp. For example, a message in the member's support chat.
"2026-01-01T12:00:00.000Z"
The member's latest lifecycle state on the account, derived from their memberships, such as paid_subscriber, canceling, or churned. null until it is first computed.
canceling, churned, finished_split_pay, paused, paid_subscriber, paid_once, expiring, joined, left, trialing, pending_entry, renewing, past_due, null "paid_subscriber"
When most_recent_action took effect, as an ISO 8601 timestamp. null when most_recent_action is null.
"2026-01-01T12:00:00.000Z"
The name the account gave this customer with PATCH /members/:id. Invoices show it as the customer name on every invoice for this member, in place of the user's own name. null when the account has not set one.
"Northwind Legal LLP"
The member's phone number: the most recent number collected (or verified) at checkout, otherwise their account number when they have shared one with this seller. null without member:phone:read on the account, or when there is neither.
"+xxxxxxxxxxx"
joined while the member is part of the account, left after they leave.
joined, left "joined"
The member's current token balance for this account, computed from token transactions.
70.25
unsubscribed once the member opts out of the account's marketing communications, null while they're subscribed. Only the member can change it.
unsubscribed, null "unsubscribed"
How much the member has spent on the account's products, in USD.
The user behind this member. null when the buyer is another business rather than a person.

