MemberPress

MemberPress Rules API

Smart Rules that protect content and drip access.

Documentation GitHub OpenAPI

Operations 5

GET /rules List rules #

POST /rules Create rule #

GET /rules/{id} Get rule #

PUT /rules/{id} Update rule #

DELETE /rules/{id} Delete rule #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/memberpress-rules-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: MemberPress Developer Tools REST Rules API
  version: v1
  summary: Members, memberships, transactions, subscriptions, groups, rules, coupons, reminders, events and webhooks for a self-hosted MemberPress WordPress site.
  description: 'The MemberPress REST API is exposed by the MemberPress **Developer Tools** add-on on the site owner''s own WordPress installation, under the WordPress REST namespace `mp/v1`. There is no MemberPress-operated SaaS host: the base URL is always `https://{site}/wp-json/mp/v1`, where `{site}` is the customer''s WordPress site.


    AUTHENTICATION. MemberPress documents two mechanisms. The Developer Tools documentation page states the API key is sent in the `MEMBERPRESS-API-KEY` request header; the MemberPress REST API documentation repository and its Postman collection send the same key in the `Authorization` header. Both are provider-published and both are modelled here. Alternatively a logged-in WordPress user holding the `remove_users` capability (typically an administrator) is authorized; a caller without it receives 401.


    PROVENANCE. **MemberPress publishes no OpenAPI description.** This document is DERIVED, not harvested. Every path, method, query parameter and request field below is transcribed from MemberPress''s own public sources: the README of https://github.com/caseproof/memberpress-rest-api-documentation, the `memberpress-api-postman-collection.json` published in that same repository (saved verbatim in this repo under `postman/`), and https://memberpress.com/docs/overview-of-using-the-developer-tools/. Response schemas are deliberately left as generic objects because MemberPress does not publish response field definitions — nothing is invented to fill the gap. Endpoints MemberPress itself flags as not present in every installation carry an `x-availability` note.'
  contact:
    name: MemberPress Support
    url: https://memberpress.com/support/
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
  x-provenance:
    generated: '2026-08-12'
    method: derived
    published_by_provider: false
    derived_by: API Evangelist enrichment pipeline
    sources:
    - https://github.com/caseproof/memberpress-rest-api-documentation/blob/main/README.md
    - https://raw.githubusercontent.com/caseproof/memberpress-rest-api-documentation/main/memberpress-api-postman-collection.json
    - https://memberpress.com/docs/overview-of-using-the-developer-tools/
    - https://memberpress.com/docs/developer-tools-actions/
    note: MemberPress publishes no OpenAPI/Swagger description on any host probed on 2026-08-12 (memberpress.com/openapi.json 404, /swagger.json 404, no spec in the caseproof GitHub organization). This description is API Evangelist's faithful transcription of MemberPress-published documentation and must not be presented as a MemberPress-published artifact.
servers:
- url: https://{site}/wp-json/mp/v1
  description: The customer's own WordPress installation. MemberPress is self-hosted; there is no vendor-operated API host.
  variables:
    site:
      default: example.com
      description: Hostname of the WordPress site running MemberPress with the Developer Tools add-on enabled.
security:
- MemberPressApiKey: []
- AuthorizationApiKey: []
tags:
- name: Rules
  description: Smart Rules that protect content and drip access.
paths:
  /rules:
    get:
      operationId: listRules
      tags:
      - Rules
      summary: List rules
      description: Lists all content access rules.
      responses:
        '200':
          description: Success. Returns a JSON array of resources. The response carries the WordPress pagination headers `X-WP-Total` and `X-WP-TotalPages`.
          headers:
            X-WP-Total:
              description: Total number of items.
              schema:
                type: integer
            X-WP-TotalPages:
              description: Total number of pages.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
        '401':
          description: Unauthorized. Returned when the API key is missing or invalid, or when the authenticated WordPress user does not hold the `remove_users` capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      parameters:
      - name: page
        in: query
        required: false
        description: Page number.
        schema:
          type: integer
          default: 1
      - name: per_page
        in: query
        required: false
        description: Items per page.
        schema:
          type: integer
          default: 10
      - name: search
        in: query
        required: false
        description: General search term.
        schema:
          type: string
      - name: orderby
        in: query
        required: false
        description: Field to order results by.
        schema:
          type: string
      - name: order
        in: query
        required: false
        description: Sort direction (ASC or DESC).
        schema:
          type: string
    post:
      operationId: createRule
      tags:
      - Rules
      summary: Create rule
      description: Creates a new access rule. `title` is required.
      responses:
        '200':
          description: Success. MemberPress returns the requested resource(s) as JSON.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Unauthorized. Returned when the API key is missing or invalid, or when the authenticated WordPress user does not hold the `remove_users` capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
                  description: Rule name.
                rule_type:
                  type: string
                  description: Type of rule.
                content_type:
                  type: string
                  description: Content type the rule protects.
                content_id:
                  type: integer
                  description: Content ID.
                drip_enabled:
                  type: boolean
                  description: Enable content dripping.
                drip_amount:
                  type: integer
                  description: Drip amount.
                drip_unit:
                  type: string
                  description: Drip unit.
                drip_after:
                  type: string
                  description: Event the drip is measured from.
                drip_after_fixed:
                  type: string
                  description: Fixed date for dripping.
                expires_enabled:
                  type: boolean
                  description: Enable expiration.
                expires_amount:
                  type: integer
                  description: Expiration amount.
                expires_unit:
                  type: string
                  description: Expiration unit.
                expires_after:
                  type: string
                  description: Event the expiration is measured from.
                expires_after_fixed:
                  type: string
                  description: Fixed expiration date.
                unauth_excerpt_type:
                  type: string
                  description: Unauthorized excerpt type.
                unauth_excerpt_size:
                  type: integer
                  description: Unauthorized excerpt size.
                unauth_message_type:
                  type: string
                  description: Unauthorized message type.
                unauth_message:
                  type: string
                  description: Unauthorized message.
                unauth_login:
                  type: boolean
                  description: Show the login form to unauthorized visitors.
                memberships:
                  type: array
                  items:
                    type: integer
                  description: IDs of the memberships granted access by this rule.
              required:
              - title
  /rules/{id}:
    get:
      operationId: getRule
      tags:
      - Rules
      summary: Get rule
      description: Gets a specific rule by ID.
      responses:
        '200':
          description: Success. MemberPress returns the requested resource(s) as JSON.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Unauthorized. Returned when the API key is missing or invalid, or when the authenticated WordPress user does not hold the `remove_users` capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      parameters:
      - name: id
        in: path
        required: true
        description: Rule ID.
        schema:
          type: integer
    put:
      operationId: updateRule
      tags:
      - Rules
      summary: Update rule
      description: Updates an existing rule.
      responses:
        '200':
          description: Success. MemberPress returns the requested resource(s) as JSON.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Unauthorized. Returned when the API key is missing or invalid, or when the authenticated WordPress user does not hold the `remove_users` capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      parameters:
      - name: id
        in: path
        required: true
        description: Rule ID.
        schema:
          type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
                  description: Rule name.
                rule_type:
                  type: string
                  description: Type of rule.
                content_type:
                  type: string
                  description: Content type the rule protects.
                content_id:
                  type: integer
                  description: Content ID.
                drip_enabled:
                  type: boolean
                  description: Enable content dripping.
                drip_amount:
                  type: integer
                  description: Drip amount.
                drip_unit:
                  type: string
                  description: Drip unit.
                drip_after:
                  type: string
                  description: Event the drip is measured from.
                drip_after_fixed:
                  type: string
                  description: Fixed date for dripping.
                expires_enabled:
                  type: boolean
                  description: Enable expiration.
                expires_amount:
                  type: integer
                  description: Expiration amount.
                expires_unit:
                  type: string
                  description: Expiration unit.
                expires_after:
                  type: string
                  description: Event the expiration is measured from.
                expires_after_fixed:
                  type: string
                  description: Fixed expiration date.
                unauth_excerpt_type:
                  type: string
                  description: Unauthorized excerpt type.
                unauth_excerpt_size:
                  type: integer
                  description: Unauthorized excerpt size.
                unauth_message_type:
                  type: string
                  description: Unauthorized message type.
                unauth_message:
                  type: string
                  description: Unauthorized message.
                unauth_login:
                  type: boolean
                  description: Show the login form to unauthorized visitors.
                memberships:
                  type: array
                  items:
                    type: integer
                  description: IDs of the memberships granted access by this rule.
    delete:
      operationId: deleteRule
      tags:
      - Rules
      summary: Delete rule
      description: Deletes a rule.
      responses:
        '200':
          description: Success. MemberPress returns the requested resource(s) as JSON.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Unauthorized. Returned when the API key is missing or invalid, or when the authenticated WordPress user does not hold the `remove_users` capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      parameters:
      - name: id
        in: path
        required: true
        description: Rule ID.
        schema:
          type: integer
components:
  schemas:
    Error:
      type: object
      description: 'MemberPress returns WordPress REST API errors. The documented success envelope is `{"success": true, "data": {...}}`; WordPress core errors carry `code`, `message` and `data.status`.'
      properties:
        code:
          type: string
          description: WordPress error code slug.
        message:
          type: string
          description: Human-readable error message.
        data:
          type: object
          properties:
            status:
              type: integer
              description: HTTP status code.
  securitySchemes:
    MemberPressApiKey:
      type: apiKey
      in: header
      name: MEMBERPRESS-API-KEY
      description: Developer Tools API key, as documented at https://memberpress.com/docs/overview-of-using-the-developer-tools/
    AuthorizationApiKey:
      type: apiKey
      in: header
      name: Authorization
      description: The same Developer Tools API key sent in the `Authorization` header, as used by the MemberPress REST API documentation repository and its Postman collection. Note this is a bare key, not an RFC 7235 `Bearer <token>` credential.
externalDocs:
  description: MemberPress REST API documentation (caseproof/memberpress-rest-api-documentation)
  url: https://github.com/caseproof/memberpress-rest-api-documentation