Paddle Connection

The Paddle Billing connection integrates your Paddle account with OpsTower, giving agents the ability to query subscriptions, analyze transactions and revenue, review customers, and inspect your product catalog. All operations are read-only.

Prerequisites

You need a Paddle Billing account with API access. Both production and sandbox environments are supported. This integration works with Paddle Billing (v2 API) only — Paddle Classic is not supported.

Credentials Required

To set up a Paddle connection, you need:

• API Key — a Paddle API key with read permissions
• Environment — whether the key is for production or sandbox

How to Create a Paddle API Key

1. In your Paddle Dashboard, go to Developer Tools > Authentication.
2. Click Generate API Key.
3. Name it something like “OpsTower Read Only”.
4. Set Read permission for the following resources:
   • Subscriptions — for MRR, churn, and subscription health analysis
   • Transactions — for revenue and payment tracking
   • Customers — for customer context and search
   • Products and Prices — for product catalog reference
5. Set None for all write operations.
6. Click Generate and copy the key.

Production keys start with pdl_live_ and sandbox keys start with pdl_sdbx_.

Setting Up the Connection in OpsTower

1. In OpsTower, navigate to Connections in the sidebar.
2. Click Add Connection and select Paddle.
3. Select your Environment (Production or Sandbox).
4. Enter your API Key.
5. Click Test Connection to verify your credentials.
6. Click Save to create the connection.

What Agents Can Do with Paddle

Once connected and enabled on an agent, the agent can:

• Query subscriptions — list active, canceled, past-due, paused, and trialing subscriptions with automatic MRR calculation, billing cycle details, and item breakdowns
• Query transactions — analyze completed transactions for revenue totals including subtotal, tax, discounts, fees, and net earnings over any time range
• Query customers — search and list customers by email, name, or status
• Query products — inspect your product catalog with pricing tiers and billing cycles

All monetary amounts from Paddle are in the smallest currency unit (e.g., cents for USD). Agents automatically convert these to readable amounts in their responses.

Use Cases

• Daily founder report: Include MRR, new subscriptions, churn, and transaction volume alongside product analytics
• Revenue investigation: “Why did MRR drop this week?” — the agent queries canceled subscriptions and correlates with product data
• Customer analysis: Search for specific customers and see their subscription status and transaction history
• Product catalog review: Understand pricing structure and active vs archived products

Troubleshooting

• Authentication failed: Verify your API key is correct. Production keys start with pdl_live_ and sandbox keys with pdl_sdbx_.
• Environment mismatch: Using a sandbox key against the production API (or vice versa) returns a 403 error. Make sure the environment setting matches your key type.
• No data returned: If using a sandbox key, only sandbox test data will be returned. Switch to a production key for live data.
• Rate limited: Paddle allows 240 requests per minute. OpsTower’s periodic queries are well within this limit. If you see a 429 error, the agent will retry automatically.