All Collections
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.

This is for FirstPromoter v2, if you are still using v1, please check this article

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?