v8

OpenAPI 3.1.02026-08-033623795.0 MB

Memberships

Add free days membership

Add free days to extend a membership's current billing period, expiration date, or Stripe trial.

Required permissions:

member:manage
member:email:read
member:basic:read

post/memberships/{id}/add_free_days

Path parameters

idstring required

Example:mem_xxxxxxxxxxxxxx

The unique identifier of the membership.

Request body

free_daysinteger required

The number of free days to add (1-1095). Extends the billing period, expiration date, or Stripe trial depending on plan type.

Example request

{
  "free_days": 42
}

Response

A successful response

cancel_at_period_endboolean required

Whether the membership is set to cancel when the current billing period ends. Only meaningful for recurring plans.

created_atstring required

When the membership was created, as an ISO 8601 timestamp.

current_period_endstring nullable required

When the current billing period renews, or when a non-renewing membership expires, as an ISO 8601 timestamp. null for one-time purchases with no expiration.

idstring required

Membership ID, prefixed mem_.

license_keystring nullable required

The software license key for this membership. Only present when the product includes a software licensing experience.

metadataobject required

Custom key-value pairs stored on the membership, commonly used for software licensing.

plan_idstring required

The plan the buyer purchased, prefixed plan_.

product_idstring required

The product this membership grants access to, prefixed prod_.

Billing state of the membership. active/trialing memberships grant access; past_due is the grace period after a failed payment; completed one-time purchases keep access; canceled/expired do not.

user_idstring nullable required

The buyer, prefixed user_. null when the buyer is another business or the membership is unclaimed.

Example response

{
  "member": {
    "access_level": "no_access"
  },
  "status": "trialing"
}