list_customers

Retrieve and manage customer data from your Paddle account by filtering, searching, and sorting results. Use pagination to access comprehensive lists of active or archived customers by email, ID, or status.

Instructions

This tool will list customers in your Paddle account.

Use the maximum perPage by default (200) to ensure comprehensive results. Filter customers by email, ID, and status as needed. Use the search parameter to find customers by ID, name, or email address. Results are paginated - use the 'after' parameter with the last ID from previous results to get the next page. Sort results using orderBy parameter. Customers can have either 'active' or 'archived' status.

Input Schema

Name	Required	Description
`after`	No	Return entities after the specified Paddle ID when working with paginated endpoints.
`email`	No	Return entities that exactly match the specified email address.
`id`	No	Return only the IDs specified.
`orderBy`	No	Order returned entities by the specified field and direction.
`perPage`	No	Set how many entities are returned per page. Default: 50; Maximum: 200.
`search`	No	Return entities that match a search query. Searches id, name, and email fields.
`status`	No	Return entities that match the specified status.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "after": {
      "description": "Return entities after the specified Paddle ID when working with paginated endpoints.",
      "type": "string"
    },
    "email": {
      "description": "Return entities that exactly match the specified email address.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "id": {
      "description": "Return only the IDs specified.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "orderBy": {
      "description": "Order returned entities by the specified field and direction.",
      "enum": [
        "id[ASC]",
        "id[DESC]"
      ],
      "type": "string"
    },
    "perPage": {
      "description": "Set how many entities are returned per page. Default: 50; Maximum: 200.",
      "type": "number"
    },
    "search": {
      "description": "Return entities that match a search query. Searches id, name, and email fields.",
      "type": "string"
    },
    "status": {
      "description": "Return entities that match the specified status.",
      "items": {
        "enum": [
          "active",
          "archived"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Paddle MCP Server

list_customers

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Paddle MCP Server

Related Tools