Paddle

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from PADDLE_API_KEY is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
PADDLE_API_KEYYesPaddle API key (pdl_live_apikey_.... for live, pdl_sdbx_apikey_.... for sandbox) Docs.

Setup

  1. Create a Paddle account: Sign up for a free sandbox account at https://sandbox-login.paddle.com/signup to test against simulated data, or use your live account at https://login.paddle.com.
  2. Create an API key: In the Paddle dashboard, go to Paddle > Developer tools > Authentication, open the API keys tab, and select New API key. Name it, assign the permissions you need (e.g. read for products, prices, customers, transactions, subscriptions; write for products), and set an expiry (default 90 days, maximum 1 year). The key is shown only once - store it securely.
  3. Configure the environment variable: Set PADDLE_API_KEY to your key. Sandbox keys start with pdl_sdbx_apikey_ and live keys with pdl_live_apikey_.

Provider notes

  • Sandbox uses a separate host: replace api.paddle.com with sandbox-api.paddle.com when working with a sandbox key. Keys are environment-specific and do not work across environments.
  • List endpoints return a data array plus meta pagination info; follow meta.pagination.next or pass the last ID as the after cursor.
  • Transactions are capped at 30 results per page; other entities support larger pages.
  • API keys expire (maximum 1 year), so rotate them before expiry to avoid outages.

Provider API reference.

Tools

ToolAccessDescription
List Products<br /><code className="reference-identifier">paddle__list_products</code>ReadList products
List Prices<br /><code className="reference-identifier">paddle__list_prices</code>ReadList prices
List Customers<br /><code className="reference-identifier">paddle__list_customers</code>ReadList customers
List Transactions<br /><code className="reference-identifier">paddle__list_transactions</code>ReadList transactions
List Subscriptions<br /><code className="reference-identifier">paddle__list_subscriptions</code>ReadList subscriptions
Get Subscription<br /><code className="reference-identifier">paddle__get_subscription</code>ReadGet subscription
Create Customer<br /><code className="reference-identifier">paddle__create_customer</code>WriteCreate customer
Create Price<br /><code className="reference-identifier">paddle__create_price</code>WriteCreate price
Create Product<br /><code className="reference-identifier">paddle__create_product</code>WriteCreate product

Verify the connection

Call a read tool such as paddle__list_products with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.