Skip to main content
PATCH
Update Member

Autorisaties

Authorization
string
header
vereist

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

member:manage
user:notifications:update

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Voorbeeld:

"2026-11-17"

Padparameters

id
string
vereist

Member ID (mber_ tag).

Body

application/json
metadata
object | null

Your own key-value data on this member. Up to 50 keys of at most 100 characters. Values are strings of at most 500 characters, numbers, true, false, or null. At most 200 KB. Replaces existing metadata, and null clears it. Requires member:manage.

Voorbeeld:
name
string | null

The name invoices show for this member, in place of the user's own. null clears it. Requires member:manage.

Maximum string length: 255
Voorbeeld:

"Northwind Legal LLP"

unsubscribe_status
enum<string> | null

unsubscribed to opt out of the account's marketing, null to opt back in. Only the member can set it, with user:notifications:update.

Beschikbare opties:
unsubscribed,
null
Voorbeeld:

"unsubscribed"

Respons

member resubscribed from their own session

access_level
enum<string>
vereist

What the member can reach on the account: customer for paying members, admin for team members, no_access once every grant has lapsed.

Beschikbare opties:
no_access,
admin,
customer
Voorbeeld:

"customer"

account_id
string
vereist

The account this member belongs to, prefixed biz_.

Voorbeeld:

"biz_xxxxxxxxxxxxxx"

created_at
string
vereist

When the member record was created, as an ISO 8601 timestamp.

Voorbeeld:

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

display_name
string
vereist

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.

Voorbeeld:

"Dana Whitfield"

earnings_usd
object | null
vereist

The user's gross income across Whop, in USD, refreshed periodically. null when the user hides their earnings or the buyer is another business.

email
string | null
vereist

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.

Voorbeeld:

"marcus@shinetime.example"

id
string
vereist

Member ID, prefixed mber_.

Voorbeeld:

"mber_xxxxxxxxxxxxxx"

joined_at
string
vereist

When the member first joined the account, as an ISO 8601 timestamp.

Voorbeeld:

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

last_accessed_at
string | null
vereist

When the member last opened the account's content, as an ISO 8601 timestamp. null if they never have.

Voorbeeld:

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

last_activity
Message · object | null
vereist

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.

last_activity_at
string | null
vereist

When the member and the account last interacted, as an ISO 8601 timestamp. For example, a message in the member's support chat.

Voorbeeld:

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

metadata
object | null
vereist

Your own key-value data stored on this member. null when none is set.

Voorbeeld:

null

most_recent_action
enum<string> | null
vereist

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.

Beschikbare opties:
canceling,
churned,
finished_split_pay,
paused,
paid_subscriber,
paid_once,
expiring,
joined,
left,
trialing,
pending_entry,
renewing,
past_due,
null
Voorbeeld:

"paid_subscriber"

most_recent_action_at
string | null
vereist

When most_recent_action took effect, as an ISO 8601 timestamp. null when most_recent_action is null.

Voorbeeld:

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

name
string | null
vereist

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.

Voorbeeld:

"Northwind Legal LLP"

phone_number
string | null
vereist

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.

Voorbeeld:

"+xxxxxxxxxxx"

status
enum<string>
vereist

joined while the member is part of the account, left after they leave.

Beschikbare opties:
joined,
left
Voorbeeld:

"joined"

token_balance
number
vereist

The member's current token balance for this account, computed from token transactions.

Voorbeeld:

70.25

unsubscribe_status
enum<string> | null
vereist

unsubscribed once the member opts out of the account's marketing communications, null while they're subscribed. Only the member can change it.

Beschikbare opties:
unsubscribed,
null
Voorbeeld:

"unsubscribed"

usd_total_spent
object
vereist

How much the member has spent on the account's products, in USD.

user
object | null
vereist

The user behind this member. null when the buyer is another business rather than a person.