Getting Started and Authenticating with Paddle
Note: Completing this authentication requires Paddle Administrator or Technical level of access that can create or view API credentials and setup webhooks.
Paddle is a Source that SaaSync supports in syncing to a Destination. To get started syncing Paddle to a Destination:
Create a SaaSync account or login to SaaSync if you already have an account,
From the SaaSync Connections page, add Paddle as a Source,
- Enter a name in the Name field,
The remainder of the instructions depend upon whether you are using Paddle Billing or Paddle Classic.
Paddle Billing Instructions
4. You can create a new Paddle API Key by going here in Paddle (Paddle > Developer Tools > Authentication). Select "+ New API key".
5. In the dialog do the following:
a. Give it a Name. Such as "SaaSync to ChartMogul".
b. Set Expires at to be "Never expires".
c. Set Permissions "All" to "Read".
d. Select Save.
6. Copy the newly generated API Key to your clipboard. Go back to SaaSync and paste it into the API Key field.
7. You DO NOT need to enter a Vendor ID for Paddle Billing. Leave that field blank.
8. In SaaSync, select Connect to Paddle. The initial sync will begin.
Setting Up Webhooks
Note: Completing all of the steps including setting up the webhooks is a requirement of this integration. Also, because this integration is reliant upon webhook history, we are only able to reconstruct history as far back as you have webhook history in your Paddle account.
9. Setting up Webhooks are required for this integration. From the SaaSync dashboard go to Connections select the vertical ellipsis on the Paddle Source.
10. Select the Webhook URL and copy it to your clipboard.
11. For Paddle Billing users, you will need to go to Notifications to setup the webhook URL.
a. Go to Paddle Notifications.
b. Add a new notification.
c. Add a Description such as "SaaSync to ChartMogul".
d. Paste the URL (from step 7 above) into the URL field.
e. Select all events.
f. Save the new destination.
Note: "Webhook Setup Required" will continue to display until Paddle sends its first successful webhook to SaaSync.
This should complete the setup process for this sync. It may take a few minutes to possibly even several days for your initial sync to complete depending upon how much data you have in Paddle.
Paddle Classic Instructions
4. Find your Paddle API Key and Vendor ID which can be found here. Return to SaaSync and enter them.
5. In SaaSync, select Connect to Paddle. The initial sync will begin.
Setting Up Webhooks
Note: Completing all of the steps including setting up the webhooks is a requirement of this integration. Also, because this integration is reliant upon webhook history, we are only able to reconstruct history as far back as you have webhook history in your Paddle account.
6. Setting up Webhooks are required for this integration. From the SaaSync dashboard go to Connections select the vertical ellipsis on the Paddle Source.
7. Select the Webhook URL and copy it to your clipboard.
8. For Paddle Classic users, you will now go to Paddle Events to add the webhook URL.
a. Go to Paddle Events to add the webhook url.
b. Paste the URL into the "URLs for receiving webhooks" section. It does NOT need to be a primary URL.
c. Now in the "Subscribing to events" section, select every webhook checkbox in each section.
d. Select Save Changes.
Note: "Webhook Setup Required" will continue to display until Paddle sends its first successful webhook to SaaSync.
This should complete the setup process for this sync. It may take a few minutes to possibly even several days for your initial sync to complete depending upon how much data you have in Paddle.