Skip to main content
All CollectionsIntegrations
How to integrate Recurly with FirstPromoter?
How to integrate Recurly with FirstPromoter?

Recurly integration with FirstPromoter

Virgil avatar
Written by Virgil
Updated over a year ago

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


To integrate Recurly with FirstPromoter, you need to follow the next steps:
​

  • Getting Started > Quick Setup > Choose Recurly and follow the steps from the Integration Wizard.

Step 1) Set API credentials

  1. Open new browser tab, login to your Recurly dashboard than go to Developers > API credentials

  2. Click on 'Add Private API key'

  3. Add a key name like 'FirstPromoter' and check 'Read-only' checkbox

  4. Click 'Save changes'

  5. Copy the Private API key and paste it into FirstPromoter Recurly Setup > Private API key field

  6. On 'Subdomain' field, enter your Recurly subdomain(look at the URL bar, if your URL is https://mycompany.recurly.com your subdomain is 'mycompany')

Step 2) Set Recurly Webhooks

  1. Go back to Recurly dashboard, go to Developers > Webhooks and click on Configure button

  2. Click on New Endpoint

  3. Copy the Webhook Endpoint URL value from FirstPromoter Recurly Setup form and paste it into Endpoint URL field on Recurly

  4. Click 'Save Changes' after you fill the Endpoint Name field

*Please make sure to select "successful payment", "successful refund", "void payment" and "cancelled subscription" events*

Step 3) Finish

Go back to FirstPromoter and click 'Save'. If you don't get any error messages, you are successfully connected to Recurly API.
​
​If you want to change the Recurly account or switch from sandbox to production environment, go to Settings > Integrations - View Integrations > Select Recurly - Setup and repeat the steps starting with Step 1).

Did this answer your question?