The Recurly App for Gladly Sidekick empowers your team and your Customers with seamless subscription management—right inside Gladly. With Recurly, Agents can quickly look up Customer accounts and subscriptions, while Customers can self-serve common requests (e.g. pause a subscription), reducing Agent workload and improving satisfaction.
Benefits
Streamlined Subscription Management
Enable Agents to view Customer subscriptions, billing details, and account information directly from Gladly.
Faster Issue Resolution
Give your Agents a real-time, single view of each Customer's subscription journey, so they can answer questions, resolve issues, and spot upsell opportunities quickly.
Reduce Agent Workload
Let Customers self-serve common subscription management tasks, reducing repetitive inquiries and freeing up Agent time for more complex needs.
Drive Retention and Revenue
Empower your Agents to proactively engage subscribers with personalized offers and timely interventions, reducing churn and increasing Customer lifetime value.
Example Use Cases
A Customer wants to pause their subscription for a period. Sidekick processes the pause and confirms the new status.
A Customer requests to cancel their subscription. Sidekick processes the cancellation and provides confirmation.
An Agent needs to quickly look up a Customer's subscription status and billing history to resolve a payment question.
A Customer wishes to reactivate a previously cancelled subscription. Sidekick guides them through the process and confirms the reactivation.
Available Actions
The Recurly App supports the following subscription management actions:
Lookup Subscription by ID
Retrieve detailed information about a specific subscription, including status, plan, billing, and key dates.
Cancel Subscription
Cancel a Customer's subscription. The subscription will continue through its current billing cycle and then expire.
Pause Subscription
Temporarily pause a Customer's subscription for a specified number of billing cycles.
Resume Subscription
Resume a paused subscription, moving it back to the active state.
Reactivate Subscription
Bring a cancelled subscription back to an active, renewing state (if still eligible).
Data Pulls
What Data Is Available?
With Recurly, you get a complete picture of each Customer, including:
Customer account details (name, email, company, address)
All active and past subscriptions
Subscription status (active, paused, cancelled, expired, etc.)
Plan details for each subscription
Billing and shipping information
Add-ons, coupons, and discounts applied
Key dates (start, end, trial, pause, renewal, etc.)
Payment and invoice status
This gives your Agents a real-time, single view of every Customer's subscription journey—so you can answer questions, resolve issues, and spot upsell opportunities quickly.
Only subscriptions belonging to a Customer are matched by Email are retrieved
Data is sorted by the most recently updated subscriptions.
How Does Customer Matching Work?
Recurly finds the right Customer by matching data from their Customer profile:
Primary email address (exact match)
If no primary email, the first email in the list of email addresses
If exactly one match is found, you'll see their account and subscriptions. If no match or more than one match is found, no Customer's data will be returned by Data Pull.
Recurly App Toolkit
Who maintains the integration
The Recurly integration is built and maintained by Gladly.
How the integration works
The Recurly App integrates with the Recurly platform via its REST API (v2021-02-25). This allows Gladly to perform queries (e.g. retrieving account and subscription details) and mutations (e.g. pausing or cancelling a subscription). Learn more about Recurly's APIs at Recurly API documentation.
Authentication is handled via private API keys included in the request headers.
Setup & Installation
Before You Start
A Recurly account with a Role that includes the Integration permission (typically Admin)
A private API key from your Recurly account
To obtain your Recurly API key:
Log in to your Recurly account as a user with the Integration permission.
Navigate to Integrations > API Credentials.
Click Add Private API Key.
Assign a name and purpose for the key, and specify the third-party application (Gladly).
Click Save Changes and copy the API key.
API keys grant full access to your Recurly account
Store API keys securely and never expose them publicly.
For more details, see the official Recurly API key documentation.
Installation
Contact Gladly Support to add this App to your Gladly instance! Please note that you need a developer resource to complete this installation.
Recurly Custom App
If you want to dive deeper into the technical details of the app you can find it in our app-platform-examples repo. You can always clone it and adapt it to your needs.