Paddle - Atako

Let your agents read and manage products, prices, customers, subscriptions, transactions, discounts and adjustments in your Paddle Billing account.

Connection

Authentication: API key.
Required settings:
- API host — sandbox-api for a sandbox account, api for production.

Sign in at paddle.com → Developer tools → Authentication → API keys → New API key. Select the permissions your agents need (product.read, price.read, customer.read/write, subscription.read, transaction.read, discount.read/write, adjustment.read) and copy the key.See Paddle’s documentation.

Read actions (11)

Action	Description
`get_customer`	Retrieve a single customer by its Paddle ID (prefixed with ctm_).
`get_product`	Retrieve a single product by its Paddle ID (prefixed with pro_).
`get_subscription`	Retrieve a single subscription by its Paddle ID (prefixed with sub_).
`get_transaction`	Retrieve a single transaction by its Paddle ID (prefixed with txn_).
`list_adjustments`	List adjustments. Filter by transaction_id, status, or customer_id. Paginate with per_page (max 50) and after.
`list_customers`	List customers. Filter by email (exact match, comma-separated), status, or search (fuzzy on id/name/email). Paginate with per_page (max 200) and after.
`list_discounts`	List discounts. Filter by status or code (comma-separated). Paginate with per_page (max 200) and after.
`list_prices`	List prices. Filter by product_id (comma-separated Paddle IDs), status, or type. Paginate with per_page (max 200) and after.
`list_products`	List products. Filter by status (active, archived) or tax_category. Use include=“prices” to embed related prices. Paginate with per_page (max 200) and after (cursor from previous response).
`list_subscriptions`	List subscriptions. Filter by status, customer_id, or price_id (comma-separated Paddle IDs). Paginate with per_page (max 200) and after.
`list_transactions`	List transactions. Filter by status, customer_id, subscription_id, or billed_at (RFC 3339, supports operators [LT], [GT], [LTE], [GTE]). Paginate with per_page (max 30) and after.

Write actions (8)

Action	Description
`cancel_subscription`	Cancel a subscription. Arguments: subscription_id (string, Paddle ID prefixed with sub_), effective_from (enum: immediately\|next_billing_period, optional, defaults to next_billing_period).
`create_customer`	Create a customer. Arguments: email (string, valid email), name (string, optional), locale (string, IETF BCP 47 tag, optional, defaults to “en”).
`create_discount`	Create a discount. Arguments: description (string, 1–500 chars), type (enum: flat\|flat_per_seat\|percentage), amount (string — cents for flat/flat_per_seat, percentage value e.g. “10” for 10%), currency_code (string, required for flat/flat_per_seat), enabled_for_checkout (boolean, defaults true), code (string, optional, 1–32 alphanumeric — auto-generated if omitted), recur (boolean, defaults false), maximum_recurring_intervals (integer ≥1, optional, requires recur), usage_limit (integer ≥1, optional), expires_at (RFC 3339 datetime, optional).
`create_price`	Create a price for a product. Arguments: product_id (string, Paddle ID prefixed with pro_), description (string, 2–500 chars, internal label not shown to customers), unit_price (object with amount as string of cents e.g. “1000” for $10.00, and currency_code e.g. “USD”), billing_cycle (object with interval enum day\|week\|month\|year and frequency integer ≥1, optional — omit for one-time prices), trial_period (object with interval, frequency, optional — requires billing_cycle), quantity (object with minimum and/or maximum integers, optional).
`create_product`	Create a product. Arguments: name (string, 1–200 chars), tax_category (enum: digital-goods, ebooks, implementation-services, professional-services, saas, software-programming-services, standard, training-services, website-hosting), description (string, optional, max 2048), image_url (string, optional, HTTPS URL to product image).
`pause_subscription`	Pause a subscription. Arguments: subscription_id (string, Paddle ID prefixed with sub_), effective_from (enum: immediately\|next_billing_period, optional, defaults to next_billing_period), resume_at (RFC 3339 datetime, optional — omit for indefinite pause).
`resume_subscription`	Resume a paused subscription. Arguments: subscription_id (string, Paddle ID prefixed with sub_), effective_from (enum: immediately\|next_billing_period, optional, defaults to next_billing_period).
`update_customer`	Update a customer. Arguments: customer_id (string, Paddle ID prefixed with ctm_), name (string, optional), email (string, optional), locale (string, optional), status (enum: active\|archived, optional).

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.