# MemberPress

> Run your WordPress membership site: add and update members, give them memberships, record and refund payments, cancel or expire subscriptions, make coupons, and start workflows when members sign up, pay, renew or cancel.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/memberpress

## Actions

### Add member

Add a member (a WordPress user), and give them a membership if you choose one. MemberPress can email them a link to set their password.

**Inputs**

- Email (`email`, text, required): The new member's email address.
- Username (`username`, text): Their WordPress username. Leave empty to use their email address.
- First name (`first_name`, text): The member's first name.
- Last name (`last_name`, text): The member's last name.
- Address line 1 (`address1`, text): Street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text): City or town.
- State (`state`, text): State, province or region.
- ZIP or postal code (`zip_code`, text): ZIP or postal code.
- Country (`country`, text): Two-letter country code, such as US or GB.
- Email a link to set a password (`send_password_email`, true/false): Send MemberPress's set-password email, so they can log in.
- Membership (`membership_id`, text): Give them this membership, recorded as a free, complete payment. Leave empty to add them with no membership.
- Membership ends (`membership_expires_at`, date and time): When that membership ends. Leave empty for access that never ends.
- Send welcome email (`send_welcome_email`, true/false): Send the membership's welcome email. Only with a membership.

**Outputs**

- `member` (object): The new member

**Example output**

```json
{
  "member": {
    "active_membership_titles": "Gold Membership",
    "active_memberships": [
      {
        "id": 15,
        "title": "Gold Membership"
      }
    ],
    "active_transaction_count": 2,
    "address": {
      "city": "Springfield",
      "country": "US",
      "line1": "123 Main St",
      "line2": "",
      "state": "UT",
      "zip": "84111"
    },
    "display_name": "jobloggs",
    "email": "jo@example.com",
    "expired_transaction_count": 0,
    "first_name": "Jo",
    "full_name": "Jo Bloggs",
    "id": 56,
    "last_name": "Bloggs",
    "login_count": 1,
    "profile": {
      "mepr_company_name": "Acme"
    },
    "registered_at": "2026-04-18T16:47:14Z",
    "subscription_count": 1,
    "username": "jobloggs"
  }
}
```

### Cancel subscription

Stop a subscription's future payments. The member keeps access until their last payment's time runs out.

**Inputs**

- Subscription ID (`subscription_id`, text, required): The subscription's ID, from 'List subscriptions' or an earlier step.

**Outputs**

- `message` (text): MemberPress's own confirmation
- `subscription` (object): The cancelled subscription

**Example output**

```json
{
  "message": "The subscription was successfully cancelled.",
  "subscription": {
    "cc_exp_month": "10",
    "cc_exp_year": "2030",
    "cc_last4": "1111",
    "coupon_id": 0,
    "created_at": "2026-04-18T16:47:19Z",
    "gateway": "manual",
    "id": 69,
    "limit_cycles": false,
    "limit_cycles_num": 2,
    "member_email": "jo@example.com",
    "member_id": 56,
    "member_name": "Jo Bloggs",
    "member_username": "jobloggs",
    "membership_id": 15,
    "membership_title": "Gold Membership",
    "period": 1,
    "period_type": "months",
    "price": "100.00",
    "status": "cancelled",
    "subscr_id": "mp-sub-5cb8a8f6a1b2c",
    "tax_amount": "0.00",
    "total": "100.00",
    "trial": false,
    "trial_amount": "0.00",
    "trial_days": 0
  }
}
```

### Create coupon

Create a coupon for some memberships: a percent or amount off every payment or only the first, with a usage limit or expiry if you like.

**Inputs**

- Memberships (`membership_ids`, list, required): The memberships the coupon can be used on.
- Discount (`discount_amount`, number, required): How much it takes off: a percent, or an amount. At least 0.
- Discount type (`discount_type`, text): Percent off or an amount off. Defaults to percent. One of: `percent` (Percent off), `dollar` (Amount off).
- Code (`coupon_code`, text): The code members enter: letters, numbers, - and _. MemberPress makes one if empty.
- Applies to (`discount_mode`, text): Every payment, only the first payment of a subscription, or a new trial in place of the membership's. Defaults to every payment. One of: `standard` (Every payment), `first-payment` (First payment only), `trial-override` (Replace the trial).
- First payment discount type (`first_payment_discount_type`, text): With 'First payment only': percent or amount off. One of: `percent` (Percent off), `dollar` (Amount off).
- First payment discount (`first_payment_discount_amount`, number): With 'First payment only': how much the first payment is reduced. At least 0.
- Trial days (`trial_days`, number): With 'Replace the trial': how long the trial lasts. At least 0.
- Trial price (`trial_amount`, number): With 'Replace the trial': what the trial costs. At least 0.
- Usage limit (`usage_limit`, number): How many times it can be used. Leave empty for no limit. At least 1.
- Expires (`expires_at`, date and time): When it stops working. Leave empty to never expire.

**Outputs**

- `coupon` (object): The new coupon

**Example output**

```json
{
  "coupon": {
    "coupon_code": "B2XJTM2YQB",
    "created_at": "2026-04-10T18:05:53Z",
    "discount_amount": "15.00",
    "discount_mode": "standard",
    "discount_type": "percent",
    "expires_at": "",
    "id": 275,
    "should_expire": false,
    "status": "publish",
    "trial_amount": "0.00",
    "trial_days": 0,
    "usage_count": 0,
    "usage_limit": 0,
    "valid_memberships": [
      {
        "id": 15,
        "title": "Gold Membership"
      }
    ]
  }
}
```

### Create membership

Create a membership (a plan members buy): one-time or recurring, with a trial, a payment limit or an end date if you like.

**Inputs**

- Name (`title`, text, required): The membership's name, shown on its sign-up page.
- Price (`price`, number): The price per billing period, such as 25 or 9.99. Defaults to 0. At least 0.
- Billing (`period_type`, text): Charge once (lifetime) or every few weeks, months or years. Defaults to a one-time payment. One of: `lifetime` (One-time payment (lifetime)), `weeks`, `months`, `years`.
- Billing every (`period`, number): How many of those weeks, months or years between payments, such as 3 for quarterly. Defaults to 1. From 1 to 365.
- Trial (`trial`, true/false): Start recurring memberships with a trial period.
- Trial days (`trial_days`, number): How long the trial lasts. At least 0.
- Trial price (`trial_amount`, number): What the trial costs. At least 0.
- Limit payments (`limit_cycles`, true/false): Stop charging after a number of payments.
- Number of payments (`limit_cycles_num`, number): With limited payments: how many to take. At least 1.
- After the last payment (`limit_cycles_action`, text): With limited payments: whether access ends or lasts for life. One of: `expire` (Access ends when the last payment expires), `lifetime` (Access for life).
- Group ID (`group_id`, text): The ID of the MemberPress group to put it in, for upgrade paths.
- Access ends (`expire_type`, text): For one-time payments: never, after a time, or on a date. One of: `none` (Never expires), `delay` (Expires after a time), `fixed` (Expires on a date).
- Access lasts (`expire_after`, number): With 'after a time': how many units access lasts. At least 1.
- Access lasts unit (`expire_unit`, text): With 'after a time': days, weeks, months or years. One of: `days`, `weeks`, `months`, `years`.
- Access ends on (`expire_fixed`, date): With 'on a date': the date access ends.
- Sign-up button text (`signup_button_text`, text): The text on the registration form's button. Defaults to Sign Up.
- Access page (`access_url`, text): The address of the page members of it can use.

**Outputs**

- `membership` (object): The new membership

**Example output**

```json
{
  "membership": {
    "access_url": "",
    "created_at": "2026-08-30T16:10:22Z",
    "expire_after": 1,
    "expire_fixed": "",
    "expire_type": "none",
    "expire_unit": "days",
    "group_id": 17,
    "id": 15,
    "limit_cycles": false,
    "limit_cycles_action": "expire",
    "limit_cycles_num": 2,
    "modified_at": "2026-09-01T21:03:22Z",
    "period": 1,
    "period_type": "months",
    "price": "100.00",
    "signup_button_text": "Sign Up",
    "status": "publish",
    "title": "Gold Membership",
    "trial": false,
    "trial_amount": "0.00",
    "trial_days": 0
  }
}
```

### Create subscription

Record a recurring subscription for a member, such as one billed elsewhere. Price and billing default to the membership's.

**Inputs**

- Member ID (`member_id`, text, required): The member's ID, from 'List members' or an earlier step.
- Membership (`membership_id`, text, required): The membership they subscribe to.
- Status (`status`, text): Defaults to active. One of: `active`, `pending`, `suspended` (Paused), `cancelled`.
- Price (`price`, number): The price per billing period before tax. Defaults to the membership's. At least 0.
- Total (`total`, number): The price per billing period with tax. Defaults to the price. At least 0.
- Billing (`period_type`, text): Every few weeks, months or years. Defaults to the membership's. One of: `weeks`, `months`, `years`.
- Billing every (`period`, number): How many weeks, months or years between payments. Defaults to the membership's. From 1 to 365.
- Payment method ID (`gateway`, text): The payment method's ID from MemberPress > Settings > Payments. Defaults to manual.
- Subscription number (`subscr_id`, text): The payment gateway's own subscription ID, so its payments are matched to this one. MemberPress makes one if empty.
- Coupon (`coupon_id`, text): The coupon used, if any.
- Trial (`trial`, true/false): Whether it starts with a trial.
- Trial days (`trial_days`, number): How long the trial lasts. At least 0.
- Trial price (`trial_amount`, number): What the trial costs. At least 0.
- Limit payments (`limit_cycles`, true/false): Stop charging after a number of payments.
- Number of payments (`limit_cycles_num`, number): With limited payments: how many to take. At least 1.
- After the last payment (`limit_cycles_action`, text): With limited payments: whether access ends or lasts for life. One of: `expire` (Access ends when the last payment expires), `lifetime` (Access for life).
- Started at (`created_at`, date and time): When it started. Defaults to now.

**Outputs**

- `subscription` (object): The new subscription

**Example output**

```json
{
  "subscription": {
    "cc_exp_month": "10",
    "cc_exp_year": "2030",
    "cc_last4": "1111",
    "coupon_id": 0,
    "created_at": "2026-04-18T16:47:19Z",
    "gateway": "manual",
    "id": 69,
    "limit_cycles": false,
    "limit_cycles_num": 2,
    "member_email": "jo@example.com",
    "member_id": 56,
    "member_name": "Jo Bloggs",
    "member_username": "jobloggs",
    "membership_id": 15,
    "membership_title": "Gold Membership",
    "period": 1,
    "period_type": "months",
    "price": "100.00",
    "status": "active",
    "subscr_id": "mp-sub-5cb8a8f6a1b2c",
    "tax_amount": "0.00",
    "total": "100.00",
    "trial": false,
    "trial_amount": "0.00",
    "trial_days": 0
  }
}
```

### Create transaction

Record a payment for a member, such as one taken elsewhere. A complete transaction gives them the membership until it ends.

**Inputs**

- Member ID (`member_id`, text, required): The member's ID, from 'List members' or an earlier step.
- Membership (`membership_id`, text, required): The membership the payment is for.
- Amount (`amount`, number): The amount before tax, such as 25 or 9.99. Defaults to 0. At least 0.
- Tax (`tax_amount`, number): The tax charged. At least 0.
- Tax rate (`tax_rate`, number): The tax rate in percent. From 0 to 100.
- Total (`total`, number): The amount including tax. Defaults to the amount plus tax. At least 0.
- Status (`status`, text): Complete gives the member access. Defaults to complete. One of: `complete`, `pending`, `failed`, `refunded`, `confirmed` (Confirmed (a subscription's sign-up)).
- Payment method ID (`gateway`, text): The payment method's ID from MemberPress > Settings > Payments. Defaults to manual.
- Transaction number (`trans_num`, text): Your own reference, such as the payment's ID elsewhere. MemberPress makes one if empty.
- Subscription ID (`subscription_id`, text): The subscription this payment belongs to, if any.
- Coupon (`coupon_id`, text): The coupon used, if any.
- Paid at (`created_at`, date and time): When it was paid. Defaults to now.
- Access ends (`expires_at`, date and time): When the access it gives ends. Leave empty for access that never ends.
- Send welcome email (`send_welcome_email`, true/false): Send the membership's welcome email, if they haven't had one.
- Send receipt (`send_receipt_email`, true/false): Email the member a receipt.

**Outputs**

- `transaction` (object): The new transaction

**Example output**

```json
{
  "transaction": {
    "amount": "100.00",
    "coupon_id": 0,
    "created_at": "2026-04-18T16:47:21Z",
    "expires_at": "2026-05-18T23:59:59Z",
    "gateway": "manual",
    "id": 199,
    "member_email": "jo@example.com",
    "member_id": 56,
    "member_name": "Jo Bloggs",
    "member_username": "jobloggs",
    "membership_id": 15,
    "membership_title": "Gold Membership",
    "status": "complete",
    "subscription_id": 69,
    "tax_amount": "0.00",
    "tax_rate": "0.000",
    "total": "100.00",
    "trans_num": "ch_1EQdOLJT1LHvX6IL",
    "txn_type": "payment"
  }
}
```

### Delete coupon

Delete a coupon so it can no longer be used.

**Inputs**

- Coupon (`coupon_id`, text, required): The coupon to delete.

**Outputs**

- `coupon_code` (text): The deleted coupon's code
- `coupon_id` (number): The ID of the coupon deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "coupon_code": "B2XJTM2YQB",
  "coupon_id": 275,
  "deleted": true
}
```

### Delete member

Delete a member's WordPress account for good. This can't be undone.

**Inputs**

- Member ID (`member_id`, text, required): The member's ID, from 'List members' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `email` (text): The deleted member's email
- `member_id` (number): The ID of the member deleted

**Example output**

```json
{
  "deleted": true,
  "email": "jo@example.com",
  "member_id": 56
}
```

### Delete membership

Delete a membership. Members who have it lose access to what it protects.

**Inputs**

- Membership (`membership_id`, text, required): The membership to delete.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `membership_id` (number): The ID of the membership deleted
- `title` (text): The deleted membership's name

**Example output**

```json
{
  "deleted": true,
  "membership_id": 15,
  "title": "Gold Membership"
}
```

### Delete subscription

Delete a subscription record. It doesn't cancel billing at the payment gateway: cancel it first.

**Inputs**

- Subscription ID (`subscription_id`, text, required): The subscription's ID, from 'List subscriptions' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `subscription_id` (number): The ID of the subscription deleted

**Example output**

```json
{
  "deleted": true,
  "subscription_id": 69
}
```

### Delete transaction

Delete a payment record. Access it gave ends; no money moves.

**Inputs**

- Transaction ID (`transaction_id`, text, required): The transaction's ID, from 'List transactions' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `transaction_id` (number): The ID of the transaction deleted

**Example output**

```json
{
  "deleted": true,
  "transaction_id": 199
}
```

### Expire subscription

End a subscription's access now, by expiring its payments that haven't run out yet.

**Inputs**

- Subscription ID (`subscription_id`, text, required): The subscription's ID, from 'List subscriptions' or an earlier step.

**Outputs**

- `message` (text): MemberPress's own confirmation
- `subscription` (object): The expired subscription

**Example output**

```json
{
  "message": "This subscription is now expired.",
  "subscription": {
    "cc_exp_month": "10",
    "cc_exp_year": "2030",
    "cc_last4": "1111",
    "coupon_id": 0,
    "created_at": "2026-04-18T16:47:19Z",
    "gateway": "manual",
    "id": 69,
    "limit_cycles": false,
    "limit_cycles_num": 2,
    "member_email": "jo@example.com",
    "member_id": 56,
    "member_name": "Jo Bloggs",
    "member_username": "jobloggs",
    "membership_id": 15,
    "membership_title": "Gold Membership",
    "period": 1,
    "period_type": "months",
    "price": "100.00",
    "status": "active",
    "subscr_id": "mp-sub-5cb8a8f6a1b2c",
    "tax_amount": "0.00",
    "total": "100.00",
    "trial": false,
    "trial_amount": "0.00",
    "trial_days": 0
  }
}
```

### Get member

Get a member with their active memberships, address, profile fields and payment counts.

**Inputs**

- Member ID (`member_id`, text, required): The member's ID, from 'List members' or an earlier step.

**Outputs**

- `member` (object): The member

**Example output**

```json
{
  "member": {
    "active_membership_titles": "Gold Membership",
    "active_memberships": [
      {
        "id": 15,
        "title": "Gold Membership"
      }
    ],
    "active_transaction_count": 2,
    "address": {
      "city": "Springfield",
      "country": "US",
      "line1": "123 Main St",
      "line2": "",
      "state": "UT",
      "zip": "84111"
    },
    "display_name": "jobloggs",
    "email": "jo@example.com",
    "expired_transaction_count": 0,
    "first_name": "Jo",
    "full_name": "Jo Bloggs",
    "id": 56,
    "last_name": "Bloggs",
    "login_count": 1,
    "profile": {
      "mepr_company_name": "Acme"
    },
    "registered_at": "2026-04-18T16:47:14Z",
    "subscription_count": 1,
    "username": "jobloggs"
  }
}
```

### Get membership

Get a membership's price, billing period, trial and access settings.

**Inputs**

- Membership (`membership_id`, text, required): The membership to get.

**Outputs**

- `membership` (object): The membership

**Example output**

```json
{
  "membership": {
    "access_url": "",
    "created_at": "2026-08-30T16:10:22Z",
    "expire_after": 1,
    "expire_fixed": "",
    "expire_type": "none",
    "expire_unit": "days",
    "group_id": 17,
    "id": 15,
    "limit_cycles": false,
    "limit_cycles_action": "expire",
    "limit_cycles_num": 2,
    "modified_at": "2026-09-01T21:03:22Z",
    "period": 1,
    "period_type": "months",
    "price": "100.00",
    "signup_button_text": "Sign Up",
    "status": "publish",
    "title": "Gold Membership",
    "trial": false,
    "trial_amount": "0.00",
    "trial_days": 0
  }
}
```

### Get subscription

Get a subscription with its status, price, billing period, member and membership.

**Inputs**

- Subscription ID (`subscription_id`, text, required): The subscription's ID, from 'List subscriptions' or an earlier step.

**Outputs**

- `subscription` (object): The subscription

**Example output**

```json
{
  "subscription": {
    "cc_exp_month": "10",
    "cc_exp_year": "2030",
    "cc_last4": "1111",
    "coupon_id": 0,
    "created_at": "2026-04-18T16:47:19Z",
    "gateway": "manual",
    "id": 69,
    "limit_cycles": false,
    "limit_cycles_num": 2,
    "member_email": "jo@example.com",
    "member_id": 56,
    "member_name": "Jo Bloggs",
    "member_username": "jobloggs",
    "membership_id": 15,
    "membership_title": "Gold Membership",
    "period": 1,
    "period_type": "months",
    "price": "100.00",
    "status": "active",
    "subscr_id": "mp-sub-5cb8a8f6a1b2c",
    "tax_amount": "0.00",
    "total": "100.00",
    "trial": false,
    "trial_amount": "0.00",
    "trial_days": 0
  }
}
```

### Get transaction

Get a payment with its amount, status, member, membership and when the access it gives ends.

**Inputs**

- Transaction ID (`transaction_id`, text, required): The transaction's ID, from 'List transactions' or an earlier step.

**Outputs**

- `transaction` (object): The transaction

**Example output**

```json
{
  "transaction": {
    "amount": "100.00",
    "coupon_id": 0,
    "created_at": "2026-04-18T16:47:21Z",
    "expires_at": "2026-05-18T23:59:59Z",
    "gateway": "manual",
    "id": 199,
    "member_email": "jo@example.com",
    "member_id": 56,
    "member_name": "Jo Bloggs",
    "member_username": "jobloggs",
    "membership_id": 15,
    "membership_title": "Gold Membership",
    "status": "complete",
    "subscription_id": 69,
    "tax_amount": "0.00",
    "tax_rate": "0.000",
    "total": "100.00",
    "trans_num": "ch_1EQdOLJT1LHvX6IL",
    "txn_type": "payment"
  }
}
```

### List access rules

List the rules that decide which pages, posts and files each membership can see, with any drip or expiry settings.

**Inputs**

- Search (`search`, text): Only rules matching this text.
- Page (`page`, number): Which page to get, from 1. Defaults to 1. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MemberPress's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `page` (number): The page number returned
- `per_page` (number): The page size asked for
- `rules` (list): The access rules

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "per_page": 10,
  "rules": [
    {
      "created_at": "2026-02-20T17:34:06Z",
      "drip_after": "registers",
      "drip_amount": 0,
      "drip_enabled": false,
      "drip_unit": "days",
      "expires_after": "registers",
      "expires_amount": 0,
      "expires_enabled": false,
      "expires_unit": "days",
      "id": 227,
      "modified_at": "2026-02-20T17:34:06Z",
      "rule_content": "225",
      "rule_type": "single_page",
      "status": "publish",
      "title": "A Single Page: Members area"
    }
  ]
}
```

### List coupons

List coupons with their discounts, limits and memberships, or find one by its code.

**Inputs**

- Code (`code`, text): Only the coupon with this code.
- Search (`search`, text): Only coupons matching this text.
- Page (`page`, number): Which page to get, from 1. Defaults to 1. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MemberPress's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many came back on this page
- `coupons` (list): The coupons
- `has_more` (true/false): True when the page was full, so the next page may have more
- `page` (number): The page number returned
- `per_page` (number): The page size asked for

**Example output**

```json
{
  "count": 1,
  "coupons": [
    {
      "coupon_code": "B2XJTM2YQB",
      "created_at": "2026-04-10T18:05:53Z",
      "discount_amount": "15.00",
      "discount_mode": "standard",
      "discount_type": "percent",
      "expires_at": "",
      "id": 275,
      "should_expire": false,
      "status": "publish",
      "trial_amount": "0.00",
      "trial_days": 0,
      "usage_count": 0,
      "usage_limit": 0,
      "valid_memberships": [
        {
          "id": 15,
          "title": "Gold Membership"
        }
      ]
    }
  ],
  "has_more": false,
  "page": 1,
  "per_page": 10
}
```

### List members

List members, or find them by email address or username. Gets one page; to see more, run it again with the next page number.

**Inputs**

- Email or username (`search`, text): Only members whose email address or username matches this.
- Page (`page`, number): Which page to get, from 1. Defaults to 1. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MemberPress's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `members` (list): The members
- `page` (number): The page number returned
- `per_page` (number): The page size asked for

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "members": [
    {
      "active_membership_titles": "Gold Membership",
      "active_memberships": [
        {
          "id": 15,
          "title": "Gold Membership"
        }
      ],
      "active_transaction_count": 2,
      "address": {
        "city": "Springfield",
        "country": "US",
        "line1": "123 Main St",
        "line2": "",
        "state": "UT",
        "zip": "84111"
      },
      "display_name": "jobloggs",
      "email": "jo@example.com",
      "expired_transaction_count": 0,
      "first_name": "Jo",
      "full_name": "Jo Bloggs",
      "id": 56,
      "last_name": "Bloggs",
      "login_count": 1,
      "profile": {
        "mepr_company_name": "Acme"
      },
      "registered_at": "2026-04-18T16:47:14Z",
      "subscription_count": 1,
      "username": "jobloggs"
    }
  ],
  "page": 1,
  "per_page": 10
}
```

### List memberships

List the memberships (plans) for sale, with their prices and billing.

**Inputs**

- Search (`search`, text): Only memberships matching this text.
- Group ID (`group_id`, text): Only memberships in this group.
- Page (`page`, number): Which page to get, from 1. Defaults to 1. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MemberPress's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `memberships` (list): The memberships
- `page` (number): The page number returned
- `per_page` (number): The page size asked for

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "memberships": [
    {
      "access_url": "",
      "created_at": "2026-08-30T16:10:22Z",
      "expire_after": 1,
      "expire_fixed": "",
      "expire_type": "none",
      "expire_unit": "days",
      "group_id": 17,
      "id": 15,
      "limit_cycles": false,
      "limit_cycles_action": "expire",
      "limit_cycles_num": 2,
      "modified_at": "2026-09-01T21:03:22Z",
      "period": 1,
      "period_type": "months",
      "price": "100.00",
      "signup_button_text": "Sign Up",
      "status": "publish",
      "title": "Gold Membership",
      "trial": false,
      "trial_amount": "0.00",
      "trial_days": 0
    }
  ],
  "page": 1,
  "per_page": 10
}
```

### List subscriptions

List recurring subscriptions, filtered by member, membership or coupon. Gets one page at a time.

**Inputs**

- Member ID (`member_id`, text): Only this member's.
- Membership (`membership_id`, text): Only subscriptions to this membership.
- Coupon (`coupon_id`, text): Only those that used this coupon.
- Search (`search`, text): Only subscriptions matching this text.
- Page (`page`, number): Which page to get, from 1. Defaults to 1. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MemberPress's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `page` (number): The page number returned
- `per_page` (number): The page size asked for
- `subscriptions` (list): The subscriptions

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "per_page": 10,
  "subscriptions": [
    {
      "cc_exp_month": "10",
      "cc_exp_year": "2030",
      "cc_last4": "1111",
      "coupon_id": 0,
      "created_at": "2026-04-18T16:47:19Z",
      "gateway": "manual",
      "id": 69,
      "limit_cycles": false,
      "limit_cycles_num": 2,
      "member_email": "jo@example.com",
      "member_id": 56,
      "member_name": "Jo Bloggs",
      "member_username": "jobloggs",
      "membership_id": 15,
      "membership_title": "Gold Membership",
      "period": 1,
      "period_type": "months",
      "price": "100.00",
      "status": "active",
      "subscr_id": "mp-sub-5cb8a8f6a1b2c",
      "tax_amount": "0.00",
      "total": "100.00",
      "trial": false,
      "trial_amount": "0.00",
      "trial_days": 0
    }
  ]
}
```

### List transactions

List payments, filtered by member, membership, subscription, coupon, status or payment method. Gets one page at a time.

**Inputs**

- Member ID (`member_id`, text): Only this member's.
- Membership (`membership_id`, text): Only payments for this membership.
- Subscription ID (`subscription_id`, text): Only this subscription's payments.
- Coupon (`coupon_id`, text): Only those that used this coupon.
- Status (`status`, text): Only transactions with this status. One of: `complete`, `pending`, `failed`, `refunded`, `confirmed` (Confirmed (a subscription's sign-up)).
- Payment method ID (`gateway`, text): Only this payment method, by the ID on MemberPress > Settings > Payments.
- Search (`search`, text): Only transactions matching this text.
- Page (`page`, number): Which page to get, from 1. Defaults to 1. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MemberPress's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `page` (number): The page number returned
- `per_page` (number): The page size asked for
- `transactions` (list): The transactions

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "per_page": 10,
  "transactions": [
    {
      "amount": "100.00",
      "coupon_id": 0,
      "created_at": "2026-04-18T16:47:21Z",
      "expires_at": "2026-05-18T23:59:59Z",
      "gateway": "manual",
      "id": 199,
      "member_email": "jo@example.com",
      "member_id": 56,
      "member_name": "Jo Bloggs",
      "member_username": "jobloggs",
      "membership_id": 15,
      "membership_title": "Gold Membership",
      "status": "complete",
      "subscription_id": 69,
      "tax_amount": "0.00",
      "tax_rate": "0.000",
      "total": "100.00",
      "trans_num": "ch_1EQdOLJT1LHvX6IL",
      "txn_type": "payment"
    }
  ]
}
```

### Refund transaction

Refund a payment through its payment gateway, and cancel its subscription too if you choose. The money goes back to the member.

**Inputs**

- Transaction ID (`transaction_id`, text, required): The transaction's ID, from 'List transactions' or an earlier step.
- Also cancel the subscription (`cancel_subscription`, true/false): Stop the subscription this payment belongs to as well.

**Outputs**

- `message` (text): MemberPress's own confirmation
- `refunded` (true/false): Always true once refunded
- `subscription_cancelled` (true/false): Whether its subscription was cancelled too
- `transaction` (object): The refunded transaction

**Example output**

```json
{
  "message": "The transaction was successfully refunded.",
  "refunded": true,
  "subscription_cancelled": false,
  "transaction": {
    "amount": "100.00",
    "coupon_id": 0,
    "created_at": "2026-04-18T16:47:21Z",
    "expires_at": "2026-05-18T23:59:59Z",
    "gateway": "manual",
    "id": 199,
    "member_email": "jo@example.com",
    "member_id": 56,
    "member_name": "Jo Bloggs",
    "member_username": "jobloggs",
    "membership_id": 15,
    "membership_title": "Gold Membership",
    "status": "refunded",
    "subscription_id": 69,
    "tax_amount": "0.00",
    "tax_rate": "0.000",
    "total": "100.00",
    "trans_num": "ch_1EQdOLJT1LHvX6IL",
    "txn_type": "payment"
  }
}
```

### Update member

Change a member's email, username, name or address. Fields left empty keep what they have.

**Inputs**

- Member ID (`member_id`, text, required): The member's ID, from 'List members' or an earlier step.
- Email (`email`, text): A new email address. Leave empty to keep it.
- Username (`username`, text): A new username. Leave empty to keep it.
- First name (`first_name`, text): The member's first name.
- Last name (`last_name`, text): The member's last name.
- Address line 1 (`address1`, text): Street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text): City or town.
- State (`state`, text): State, province or region.
- ZIP or postal code (`zip_code`, text): ZIP or postal code.
- Country (`country`, text): Two-letter country code, such as US or GB.

**Outputs**

- `member` (object): The member as it is now

**Example output**

```json
{
  "member": {
    "active_membership_titles": "Gold Membership",
    "active_memberships": [
      {
        "id": 15,
        "title": "Gold Membership"
      }
    ],
    "active_transaction_count": 2,
    "address": {
      "city": "Springfield",
      "country": "US",
      "line1": "123 Main St",
      "line2": "",
      "state": "UT",
      "zip": "84111"
    },
    "display_name": "jobloggs",
    "email": "jo@example.com",
    "expired_transaction_count": 0,
    "first_name": "Jo",
    "full_name": "Jo Bloggs",
    "id": 56,
    "last_name": "Bloggs",
    "login_count": 1,
    "profile": {
      "mepr_company_name": "Acme"
    },
    "registered_at": "2026-04-18T16:47:14Z",
    "subscription_count": 1,
    "username": "jobloggs"
  }
}
```

### Update membership

Change a membership's name, price, billing or access settings. Fields left empty keep what they have.

**Inputs**

- Membership (`membership_id`, text, required): The membership to change.
- Name (`title`, text): A new name. Leave empty to keep it.
- Price (`price`, number): The price per billing period, such as 25 or 9.99. Defaults to 0. At least 0.
- Billing (`period_type`, text): Charge once (lifetime) or every few weeks, months or years. Defaults to a one-time payment. One of: `lifetime` (One-time payment (lifetime)), `weeks`, `months`, `years`.
- Billing every (`period`, number): How many of those weeks, months or years between payments, such as 3 for quarterly. Defaults to 1. From 1 to 365.
- Trial (`trial`, true/false): Start recurring memberships with a trial period.
- Trial days (`trial_days`, number): How long the trial lasts. At least 0.
- Trial price (`trial_amount`, number): What the trial costs. At least 0.
- Limit payments (`limit_cycles`, true/false): Stop charging after a number of payments.
- Number of payments (`limit_cycles_num`, number): With limited payments: how many to take. At least 1.
- After the last payment (`limit_cycles_action`, text): With limited payments: whether access ends or lasts for life. One of: `expire` (Access ends when the last payment expires), `lifetime` (Access for life).
- Group ID (`group_id`, text): The ID of the MemberPress group to put it in, for upgrade paths.
- Access ends (`expire_type`, text): For one-time payments: never, after a time, or on a date. One of: `none` (Never expires), `delay` (Expires after a time), `fixed` (Expires on a date).
- Access lasts (`expire_after`, number): With 'after a time': how many units access lasts. At least 1.
- Access lasts unit (`expire_unit`, text): With 'after a time': days, weeks, months or years. One of: `days`, `weeks`, `months`, `years`.
- Access ends on (`expire_fixed`, date): With 'on a date': the date access ends.
- Sign-up button text (`signup_button_text`, text): The text on the registration form's button. Defaults to Sign Up.
- Access page (`access_url`, text): The address of the page members of it can use.

**Outputs**

- `membership` (object): The membership as it is now

**Example output**

```json
{
  "membership": {
    "access_url": "",
    "created_at": "2026-08-30T16:10:22Z",
    "expire_after": 1,
    "expire_fixed": "",
    "expire_type": "none",
    "expire_unit": "days",
    "group_id": 17,
    "id": 15,
    "limit_cycles": false,
    "limit_cycles_action": "expire",
    "limit_cycles_num": 2,
    "modified_at": "2026-09-01T21:03:22Z",
    "period": 1,
    "period_type": "months",
    "price": "100.00",
    "signup_button_text": "Sign Up",
    "status": "publish",
    "title": "Gold Membership",
    "trial": false,
    "trial_amount": "0.00",
    "trial_days": 0
  }
}
```
