Update a membership
Changes whether the membership renews, when it ends, and whether it is active, paused, or cancelled. Cancelling stamps the cancellation date, as cancelling in 1club does.
Changing the plan is not supported: that is a priced change needing proration, invoicing and possibly a refund. Move the customer to another plan in 1club instead.
Authorizations
Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.
Path Parameters
Body
Statuses the platform derives itself (expired, used, pending_payment) cannot be set here. Send status on its own - autoRenew and the allowance fields cannot be combined with it, because a status transition sets them itself. active only applies to a paused membership.
active, paused, cancelled Only valid with status: cancelled. Keep access until the paid period ends, or end it today.
immediate, end_of_period Only valid with status: paused. When the pause lifts by itself; must be in the future.
Session allowance; null for unlimited
Sessions left, for correcting a balance after a migration
Response
The updated membership
A customer's membership on a plan. The plan is snapshotted onto it at creation, so allowance and coverage behave exactly as they do for a membership sold in 1club.
Stable unguessable identifier. Prefer this over membershipId when storing a reference.
Customer the membership belongs to
Club the membership is limited to; null when it applies organization-wide.
active, paused, cancelled, expired, used, pending, or pending_payment
Session allowance snapshotted from the plan; null when unlimited.