Recurly

Overview

Recurly provides billing management for many subscription businesses. The Recurly/Grow integration offers businesses a platform to manage all of their subscription data in one place. This article will give you an overview of the integration itself.

NOTE: This data source is only available for accounts on the Basic and Professional plans. If you would like to upgrade your plan, talk to your Grow account manager or visit your account's billing page.

How to Connect

Before you get started you will need your Recurly API Key and Domain.

1. Log in to your Grow account and click Add Metric. Select Recurly from the list of Data Sources. Select Connect.
2. In order to connect your Recurly account, you’ll need your API Key and Domain.
3. To get your API Key, you’ll need to have manager or admin permissions in Recurly. Log in to your Recurly account, then click on  Developers in the menu. From here, select API Credentials.
4. At the bottom of the screen, click on the button labeled Add Private API Key button.
5. Add a name for your API Key and any notes that you need about what it will be used for. In the section about a third-party application, select Grow as the application using the key.
6. Click Save Changes.
7. After you get your API Key, copy it into Grow.
8. In the domain field, enter the subdomain you have created for your account. Press Submit.

And that's it! You are good to go.

Endpoints

Below is a list of the reports that the Recurly/Grow integration offers, along with a short description of each. 

For the Subscriptions and Accounts reports, there is an additional field that you must choose, labeled State *. Each state is shown in the bullet point lists below, along with the description of the data they provide. 

Subscriptions

• Active: Plan name, state, billing information, and notes for active subscriptions
• Canceled: Plan name, state, billing information, and notes for canceled subscriptions
• Expired: Plan name, state, billing information, and notes for expired subscriptions
• Future: Plan name, state, billing information, and notes for future subscriptions
• In Trial: Plan name, state, billing information, and notes for subscriptions in trial
• Live: Plan name, state, billing information, and notes for live subscriptions
• Past Due: Plan name, state, billing information, and notes for subscriptions that are past due.

Accounts

• Active: Name, company, and account details for active accounts
• Closed: Name, company, and account details for active accounts

Invoices: Account ID, invoice number, company info and invoice amounts