Integrations / Payments

Paddle

Look up customers, transactions and subscriptions, fetch invoice PDFs, cancel subscriptions, and trigger workflows from Paddle Billing events.

10 tools 18 trigger events

Tools

paddle.search_customers

Search customers by name or email, or look them up by exact email. Customer IDs look like ctm_01h844p3h41s12zs5mn4axja51.

searchemailper_page

paddle.get_customer

Get a customer by ID, e.g. ctm_01h844p3h41s12zs5mn4axja51.

customer_id*

paddle.list_transactions

List transactions, newest first, optionally for one customer or subscription. Transaction IDs look like txn_01h04vsbhqc62t8hmd4z3b578c.

customer_idsubscription_idstatusper_page

paddle.get_invoice_pdf

Get a link to a transaction's invoice PDF, valid for one hour. Only billed or completed transactions have one.

transaction_id*

paddle.list_subscriptions

List subscriptions, optionally for one customer or status. Subscription IDs look like sub_01h04vsc0qhwtsbsxh3422wjs4.

customer_idstatusper_page

paddle.get_subscription

Get a subscription by ID, e.g. sub_01h04vsc0qhwtsbsxh3422wjs4, with its items and customer portal links.

subscription_id*

paddle.cancel_subscription writes

Cancel a subscription at the end of its billing period, or immediately. A canceled subscription can't be reinstated.

subscription_id*effective_from

paddle.refund_transaction writes

Request a full refund of a billed or completed transaction, or a refund of some of its line items, as an adjustment that Paddle may review before approving. Adjustment IDs start with adj_.

transaction_id*reason*typetax_modeitems

paddle.api_get

Send a GET request to any Paddle API path under https://{api_host} and return the response. For endpoints the named tools don't cover.

path*params

paddle.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Paddle API path under https://{api_host}.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any Paddle API path.

Connect

  1. In the Paddle dashboard, open Developer tools → Authentication and create an API key with read access to customers, transactions and subscriptions, plus subscription write if workflows cancel subscriptions.
  2. Paste the key (pdl_live_apikey_… or pdl_sdbx_apikey_…) on the connection and pick the matching environment.
  3. To trigger workflows, add a webhook destination under Developer tools → Notifications with the URL shown on the connection page, choose the events you need, and paste the destination's secret key on the connection.

Credentials

API key Webhook secret key

Paddle API docs

Triggers

In the Paddle dashboard, go to Developer tools → Notifications, add a webhook destination with this URL and the events your workflows use, then copy its secret key from Edit destination onto this connection.

Events

customer.createdcustomer.updatedsubscription.createdsubscription.activatedsubscription.updatedsubscription.trialingsubscription.past_duesubscription.pausedsubscription.resumedsubscription.canceledtransaction.createdtransaction.billedtransaction.paidtransaction.completedtransaction.payment_failedtransaction.past_dueadjustment.createdadjustment.updated
 trigger
kind: paddle
connection: paddle
events: [customer.created]
customers: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.

Start free trial Talk to us