Paddle
Also an agent toolPaddle Billing API (v-2023+, not Paddle Classic): manage products, prices, discounts, customers (and their addresses, businesses, payment methods, credit balances, and auth tokens), transactions (create/list/get/update, preview, invoice PDF), subscriptions (get/preview-update/update/pause/resume/cancel/one-time-charge/update-payment-method transaction), adjustments (refunds/credits + credit-note PDF), reports (create/list/get/CSV), events + event types, notification settings/destinations CRUD, notifications (list/get/logs/replay), pricing preview, and simulations. Bearer API-key auth; production host api.paddle.com and sandbox host sandbox-api.paddle.com are both modelled (PH-ENV-01 environments) and selected on the connector instance. Change notifications use polling (list Transactions / list Events cursor); native Paddle webhooks are signed with an HMAC-SHA256-over-'ts:body' scheme that is not one of Zervanor's registered signature handlers, so they are documented for reference and the trigger path is polling.
73 actions · 17 triggers
The Paddle integration lets you connect Paddle to your automations with 73 actions and 17 triggers — and every action is also a tool an AI agent can call. Examples: List Event Types, Create Product, List Products, Get Product, Update Product. No blank-canvas wiring — connect it and use it in your workflows.
Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.
Triggers 17
Events in Paddle that can start a workflow.
Transaction Completed
Fires on the Paddle `transaction.completed` notification.
Transaction Paid
Fires on the Paddle `transaction.paid` notification.
Transaction Payment Failed
Fires on the Paddle `transaction.payment_failed` notification.
Transaction Past Due
Fires on the Paddle `transaction.past_due` notification.
Transaction Canceled
Fires on the Paddle `transaction.canceled` notification.
Transaction Created
Fires on the Paddle `transaction.created` notification.
Transaction Updated
Fires on the Paddle `transaction.updated` notification.
Transaction Ready
Fires on the Paddle `transaction.ready` notification.
Subscription Created
Fires on the Paddle `subscription.created` notification.
Subscription Updated
Fires on the Paddle `subscription.updated` notification.
Subscription Canceled
Fires on the Paddle `subscription.canceled` notification.
Subscription Paused
Fires on the Paddle `subscription.paused` notification.
Subscription Past Due
Fires on the Paddle `subscription.past_due` notification.
Customer Created
Fires on the Paddle `customer.created` notification.
Customer Updated
Fires on the Paddle `customer.updated` notification.
New / updated Paddle transactions
Polls GET /transactions ordered by updated_at ASC and pages via the 'after' id cursor from meta.pagination.next. Dedupe by transaction id; advance by updated_at.
New Paddle events (all types)
Polls GET /events and pages via the 'after' id cursor from meta.pagination.next. A firehose of every event type Paddle emits; dedupe by event_id.
Actions 73
What Zervanor can do in Paddle.
Customers17
Create Customer
Create a customer (POST /customers).
List Customers
List customers (GET /customers). Cursor pagination via 'after'.
Get Customer
Get a customer by id (GET /customers/{customer_id}).
Update Customer
Update a customer (PATCH /customers/{customer_id}). Set status to 'archived' to archive.
List Customer Credit Balances
List a customer's credit balances by currency (GET /customers/{customer_id}/credit-balances).
Generate Customer Auth Token
Generate a customer authentication token for use with Paddle.js customer portal / Retain (POST /customers/{customer_id}/auth-token).
Create Customer Address
Create an address for a customer (POST /customers/{customer_id}/addresses).
List Customer Addresses
List a customer's addresses (GET /customers/{customer_id}/addresses). Cursor pagination via 'after'.
Get Customer Address
Get a customer's address by id (GET /customers/{customer_id}/addresses/{address_id}).
Update Customer Address
Update a customer's address (PATCH /customers/{customer_id}/addresses/{address_id}).
Create Customer Business
Create a business for a customer (POST /customers/{customer_id}/businesses).
List Customer Businesses
List a customer's businesses (GET /customers/{customer_id}/businesses). Cursor pagination via 'after'.
Get Customer Business
Get a customer's business by id (GET /customers/{customer_id}/businesses/{business_id}).
Update Customer Business
Update a customer's business (PATCH /customers/{customer_id}/businesses/{business_id}).
List Customer Payment Methods
List a customer's saved payment methods (GET /customers/{customer_id}/payment-methods). Cursor pagination via 'after'.
Get Customer Payment Method
Get a customer's saved payment method by id (GET /customers/{customer_id}/payment-methods/{payment_method_id}).
Delete Customer Payment Method
Delete a customer's saved payment method (DELETE /customers/{customer_id}/payment-methods/{payment_method_id}).
Subscriptions10
List Subscriptions
List subscriptions (GET /subscriptions). Cursor pagination via 'after'.
Get Subscription
Get a subscription by id (GET /subscriptions/{subscription_id}).
Preview Update Subscription
Preview the effect of updating a subscription without applying it (PATCH /subscriptions/{subscription_id}/preview).
Update Subscription
Update a subscription (PATCH /subscriptions/{subscription_id}) — change items, quantities, discount, billing date, or custom data.
Get Subscription Update Payment Method Transaction
Get a transaction that can be passed to a checkout to let a customer update the payment method for a past-due subscription (GET /subscriptions/{subscription_id}/update-payment-method-transaction).
Pause Subscription
Pause a subscription (POST /subscriptions/{subscription_id}/pause).
Resume Subscription
Resume a paused subscription (POST /subscriptions/{subscription_id}/resume).
Cancel Subscription
Cancel a subscription (POST /subscriptions/{subscription_id}/cancel).
Create Subscription One-Time Charge
Create a one-time charge for items added to a subscription (POST /subscriptions/{subscription_id}/charge).
Preview Subscription One-Time Charge
Preview a one-time charge for a subscription without applying it (POST /subscriptions/{subscription_id}/charge/preview).
Simulations7
Create Simulation
Create a webhook simulation to test how your destination handles events (POST /simulations).
List Simulations
List webhook simulations (GET /simulations). Cursor pagination via 'after'.
Get Simulation
Get a simulation by id (GET /simulations/{simulation_id}).
Update Simulation
Update a simulation (PATCH /simulations/{simulation_id}).
Run Simulation
Start a run of a simulation (POST /simulations/{simulation_id}/runs).
List Simulation Runs
List runs for a simulation (GET /simulations/{simulation_id}/runs). Cursor pagination via 'after'.
Get Simulation Run
Get a simulation run by id (GET /simulations/{simulation_id}/runs/{run_id}).
Transactions6
Create Transaction
Create a transaction (POST /transactions). Use to bill a customer, create an invoice, or build a checkout.
List Transactions
List transactions (GET /transactions). Cursor pagination via 'after'; supports updated_at filter for change polling.
Get Transaction
Get a transaction by id (GET /transactions/{transaction_id}).
Update Transaction
Update a transaction (PATCH /transactions/{transaction_id}). Only draft/ready transactions can be modified; set status to 'billed' or 'canceled' to progress an invoice.
Get Transaction Invoice PDF
Get a URL to the invoice PDF for a billed/completed transaction (GET /transactions/{transaction_id}/invoice). Returns a short-lived download URL.
Preview Transaction
Preview a transaction's totals, tax, and discounts without creating it (POST /transactions/preview).
Notification Settings5
Create Notification Destination
Create a notification destination (webhook endpoint or email) that Paddle delivers events to (POST /notification-settings).
List Notification Destinations
List notification destinations (GET /notification-settings).
Get Notification Destination
Get a notification destination by id (GET /notification-settings/{notification_setting_id}).
Update Notification Destination
Update a notification destination (PATCH /notification-settings/{notification_setting_id}).
Delete Notification Destination
Delete a notification destination (DELETE /notification-settings/{notification_setting_id}).
Products5
Create Product
Create a product (POST /products).
List Products
List products (GET /products). Cursor pagination via 'after'.
Get Product
Get a product by id (GET /products/{product_id}).
Update Product
Update a product (PATCH /products/{product_id}). Set status to 'archived' to archive.
Archive Product
Archive a product (PATCH /products/{product_id} with status=archived). Paddle has no hard-delete for products; archiving is the safe reversal for a created product.
Discounts4
Create Discount
Create a discount (POST /discounts).
List Discounts
List discounts (GET /discounts). Cursor pagination via 'after'.
Get Discount
Get a discount by id (GET /discounts/{discount_id}).
Update Discount
Update a discount (PATCH /discounts/{discount_id}).
Notifications4
List Notifications
List notifications (delivery attempts) Paddle sent to your destinations (GET /notifications). Cursor pagination via 'after'.
Get Notification
Get a notification by id (GET /notifications/{notification_id}).
Get Notification Logs
Get delivery logs (attempts) for a notification (GET /notifications/{notification_id}/logs).
Replay Notification
Replay (re-send) a notification to its destination (POST /notifications/{notification_id}/replay).
Prices4
Create Price
Create a price for a product (POST /prices).
List Prices
List prices (GET /prices). Cursor pagination via 'after'.
Get Price
Get a price by id (GET /prices/{price_id}).
Update Price
Update a price (PATCH /prices/{price_id}).
Reports4
Create Report
Create a report export job (POST /reports). Reports are generated asynchronously and downloaded via the CSV action.
List Reports
List reports (GET /reports). Cursor pagination via 'after'.
Get Report
Get a report by id (GET /reports/{report_id}).
Get Report CSV
Get a URL to download a ready report as CSV (GET /reports/{report_id}/download-url). Returns a short-lived download URL.
Adjustments3
Create Adjustment
Create an adjustment — refund, credit, or chargeback correction — against a transaction (POST /adjustments).
List Adjustments
List adjustments (GET /adjustments). Cursor pagination via 'after'.
Get Adjustment Credit Note PDF
Get a URL to the credit note PDF for an adjustment (GET /adjustments/{adjustment_id}/credit-note). Returns a short-lived download URL.
Event Types1
List Event Types
List all event types Paddle can emit (GET /event-types). Safe identity + connectivity probe; requires a valid API key.
Events1
List Events
List events from the account's event stream (GET /events). Cursor pagination via 'after'; a general-purpose change feed for polling.
Pricing Preview1
Preview Prices (Pricing Preview)
Preview calculated totals — including localized prices, tax, and discounts — for a set of prices (POST /pricing-preview). Powers dynamic pricing pages.
Simulation Types1
List Simulation Types
List available simulation types/scenarios Paddle supports (GET /simulation-types).
Nothing matches your search.
Automations using Paddle
Build your own automation with Paddle in the visual builder.
Frequently asked questions
What can I automate with Paddle?
73 actions are available — for example: List Event Types, Create Product, List Products, Get Product, Update Product, and more.
Which Paddle events can start a workflow?
17 triggers — for example: Transaction Completed, Transaction Paid, Transaction Payment Failed, Transaction Past Due.
Can Paddle be used as an AI agent tool?
Yes. Every Paddle action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.
How is the Paddle integration modelled?
Paddle is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.