> ## Documentation Index > Fetch the complete documentation index at: https://docs.atako.ai/llms.txt > Use this file to discover all available pages before exploring further. # Paddle > Connect Paddle to your Atako agents — 11 read and 8 write actions. 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](https://developer.paddle.com/dashboard/authentication). ## 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](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected. *** *Last reviewed against the provider API: September 2026.*