---
title: "Paddle integration"
description: "Paddle uses an API key (no OAuth), so generate one with the right scopes, paste it into Cometly, and create events for every billing signal you care about. Pass the comet_token from embedded checkouts and attribution stays clean across domains."
source: "https://www.cometly.com/integration/paddle"
---

# Paddle integration for Cometly

Tie Paddle transactions, customers, and subscriptions to ad performance.

Paddle uses an API key (no OAuth), so generate one with the right scopes, paste it into Cometly, and create events for every billing signal you care about. Pass the comet_token from embedded checkouts and attribution stays clean across domains.

- Category: Payments
- Connection method: API Key

## What you can do

- Track transactions, new customers, and new subscriptions in real time
- Map Paddle fields like Email, Amount, Phone, and comet_token
- Multi-event support — track different Paddle products separately
- Embedded checkout helper script keeps cross-domain attribution intact

## Setup (API Key)

1. In Paddle, go to Developer Tools → Authentication and create an API key with the required permissions.
2. In Cometly, open Apps & Integrations, search for Paddle, and paste the key.
3. In Events Manager, create events for the Paddle triggers you want.
4. Map Paddle fields (Email, Event Time, Amount, comet_token) to Cometly fields.
5. For embedded checkouts, add the Cometly helper script underneath the pixel.

## Events

| Event | Description |
| --- | --- |
| Transaction Completed | Fires when a Paddle payment completes. |
| Customer Created | Fires when a new buyer is created in Paddle. |
| Subscription Created | Fires when a customer starts a new subscription. |