Skip to main content
All CollectionsIntegrations
How to integrate Recurly
How to integrate Recurly

Recurly integration with FirstPromoter

Harvey Gil avatar
Written by Harvey Gil
Updated over a week ago

FirstPromoter allows you to automatically track sales, refunds, upgrades and cancellations from Recurly.

1. Accessing Recurly Integration

  • Navigate to your profile located in the upper-right section and select "Settings";

  • Access the "Integrations" tab;

  • Scroll down to the "Integrations with third-parties" section;

  • Select "Setup" under Recurly.


​

2. Setting API Credentials

  • Open a new browser tab and log in to your Recurly dashboard;

  • Navigate to Developers > API credentials;

  • Click on "Add Private API key";

  • Provide a descriptive key name like 'FirstPromoter' and check the 'Read-only' checkbox;

  • Click "Save changes";

  • Copy the Private API key generated by Recurly;

  • Paste the copied Private API key into the "Private API key" field in the FirstPromoter Recurly Setup section;

  • In the "Subdomain" field, enter your Recurly subdomain (found in the URL bar of your Recurly dashboard).

3. Setting Recurly Webhooks

  • Return to your Recurly dashboard and navigate to Developers > Webhook;

  • Click on "Configure";

  • Click on "New Endpoint";

  • Copy the Webhook Endpoint URL value from the FirstPromoter Recurly Setup form and paste it into the 'Endpoint URL' field on Recurly;

  • Provide a descriptive name for the endpoint in the "Endpoint Name" field;

  • Click "Save Changes".

Note: Ensure you've selected "successful payment", "successful refund", "void payment", and "cancelled subscription" events.
​

4. Completion

  • Return to FirstPromoter and click "Save". If no error messages occur, you are successfully connected to the Recurly API.

Note: To make changes to the Recurly account or switch between sandbox and production environments, navigate to Settings > Integrations tab - Integrations with third parties > Select Recurly - update, and repeat the steps starting from Step 1.

Did this answer your question?