← Tools Reference

Paddle

Paddle integration (Finance). Imported from open-connector.

API key12 toolshttps://api.paddle.com
GET
paddle_list_products
List Paddle products with optional filtering, pagination, and price inclusion.

/products

9 parameters
ParamTypeRequiredDescription
afterstringoptionalPaddle ID cursor returned in a previous list response.
perPageintegeroptionalMaximum number of entities to request from Paddle.
orderBystringoptionalPaddle order_by expression such as `id[DESC]`.
skipCountbooleanoptionalWhether to send Skip-Count: true to speed up list responses.
idsarrayoptionalProduct IDs to return.
includearrayoptionalRelated entities to include in each product.
statusarrayoptionalProduct statuses to return.
taxCategoryarrayoptionalProduct tax categories to return.
typestringoptionalPaddle entity type.
GET
paddle_get_product
Get one Paddle product by ID.

/products/{id}

1 parameter
ParamTypeRequiredDescription
idstringrequiredPaddle product ID, prefixed with `pro_`.
POST
paddle_create_product
Create a Paddle product in the catalog.

/products

6 parameters
ParamTypeRequiredDescription
namestringrequiredName of the product.
descriptionstringoptionalShort description for the product.
tax_categorystringoptionalPaddle product tax category.
typestringoptionalPaddle entity type.
image_urlstringoptionalImage URL for this product.
custom_dataobjectoptional
PATCH
paddle_update_product
Update a Paddle product, including archiving or reactivating it through status.

/products/{id}

8 parameters
ParamTypeRequiredDescription
idstringrequiredPaddle product ID, prefixed with `pro_`.
namestringoptionalName of the product.
descriptionstringoptionalShort description for the product.
tax_categorystringoptionalPaddle product tax category.
typestringoptionalPaddle entity type.
image_urlstringoptionalImage URL for this product.
custom_dataobjectoptional
statusstringoptionalPaddle entity status.
GET
paddle_list_prices
List Paddle prices with optional product, status, recurring, and billing filters.

/prices

12 parameters
ParamTypeRequiredDescription
afterstringoptionalPaddle ID cursor returned in a previous list response.
perPageintegeroptionalMaximum number of entities to request from Paddle.
orderBystringoptionalPaddle order_by expression such as `id[DESC]`.
skipCountbooleanoptionalWhether to send Skip-Count: true to speed up list responses.
idsarrayoptionalPrice IDs to return.
includearrayoptionalRelated entities to include in each price.
productIdsarrayoptionalProduct IDs whose prices should be returned.
statusarrayoptionalPrice statuses to return.
recurringbooleanoptionalWhether to return recurring prices.
billingCycleIntervalstringoptionalBilling interval unit.
billingCycleFrequencyintegeroptionalBilling cycle frequency to filter by.
typestringoptionalPaddle entity type.
GET
paddle_get_price
Get one Paddle price by ID.

/prices/{id}

1 parameter
ParamTypeRequiredDescription
idstringrequiredPaddle price ID, prefixed with `pri_`.
POST
paddle_create_price
Create a Paddle price for a product.

/prices

10 parameters
ParamTypeRequiredDescription
product_idstringrequiredPaddle product ID, prefixed with `pro_`.
descriptionstringrequiredInternal description for this price.
unit_priceobjectrequiredMoney amount in Paddle's lowest currency denomination.
typestringoptionalPaddle entity type.
namestringoptionalName of this price.
billing_cycleobjectoptional
trial_periodobjectoptional
tax_modestringoptionalHow Paddle should calculate tax for this price.
quantityobjectoptionalQuantity limits for the related product at this price.
custom_dataobjectoptional
PATCH
paddle_update_price
Update a Paddle price, including archiving or reactivating it through status.

/prices/{id}

12 parameters
ParamTypeRequiredDescription
idstringrequiredPaddle price ID, prefixed with `pri_`.
product_idstringoptionalPaddle product ID, prefixed with `pro_`.
descriptionstringoptionalInternal description for this price.
unit_priceobjectoptionalMoney amount in Paddle's lowest currency denomination.
typestringoptionalPaddle entity type.
namestringoptionalName of this price.
billing_cycleobjectoptional
trial_periodobjectoptional
tax_modestringoptionalHow Paddle should calculate tax for this price.
quantityobjectoptionalQuantity limits for the related product at this price.
custom_dataobjectoptional
statusstringoptionalPaddle entity status.
GET
paddle_list_customers
List Paddle customers with optional email, status, search, and pagination filters.

/customers

8 parameters
ParamTypeRequiredDescription
afterstringoptionalPaddle ID cursor returned in a previous list response.
perPageintegeroptionalMaximum number of entities to request from Paddle.
orderBystringoptionalPaddle order_by expression such as `id[DESC]`.
skipCountbooleanoptionalWhether to send Skip-Count: true to speed up list responses.
idsarrayoptionalCustomer IDs to return.
emailsarrayoptionalEmail addresses to match exactly.
statusarrayoptionalCustomer statuses to return.
searchstringoptionalSearch query matched against customer ID, name, and email.
GET
paddle_get_customer
Get one Paddle customer by ID.

/customers/{id}

1 parameter
ParamTypeRequiredDescription
idstringrequiredPaddle customer ID, prefixed with `ctm_`.
POST
paddle_create_customer
Create a Paddle customer.

/customers

4 parameters
ParamTypeRequiredDescription
namestringoptionalFull name for this customer.
emailstringrequiredEmail address for this customer.
localestringoptionalIETF BCP 47 locale tag for this customer.
custom_dataobjectoptional
PATCH
paddle_update_customer
Update a Paddle customer, including archiving or reactivating it through status.

/customers/{id}

6 parameters
ParamTypeRequiredDescription
idstringrequiredPaddle customer ID, prefixed with `ctm_`.
namestringoptionalFull name for this customer.
emailstringoptionalEmail address for this customer.
localestringoptionalIETF BCP 47 locale tag for this customer.
custom_dataobjectoptional
statusstringoptionalPaddle entity status.