Automated Exports runs nightly, pulling a full snapshot of your Recurly data and making it available through the API. It's built for teams that want their data warehouse to stay current without manual intervention — no scheduled logins, no copy-paste exports. Configure your exports once in the Integrations section, then retrieve fresh data every day via a private API key.
- The Integrations role assigned to any users who need access to the Automated Exports UI. Some admin-level exports also require the Admin role.
- The necessary configurations set up in the Integrations section of the Recurly admin console.
- Familiarity with the Recurly API to retrieve daily exports.
- Not available in sandbox mode.
- Only full data sets are available — partial sets based on status filters (as seen in the Exports UI) are not supported.
- A new export version doesn't automatically update your existing configuration. You'll need to reconfigure manually to access the latest version.
- Export files are accessible via the Recurly API for 60 days after creation. After that, they expire.
Automated Exports is a Recurly feature that runs nightly scheduled data exports, delivering a full snapshot of the previous day's data to your data warehouse. Each export provides a broader set of object attributes than what's available through individual API objects, making it well-suited for analytics, reporting, and data sync workflows.
Automated process
Schedule exports to run every night without lifting a finger — no manual downloads, no console logins required.
Richer data
Access a broader set of attributes per object than the standard API exposes — giving your analysts more to work with.
Smooth sandbox-to-production transition
Export schedules configured in sandbox mode carry over when you switch to production, so you don't have to start from scratch.
Secure data retrieval
Exported data is accessed via secure, time-limited URLs — each one valid for 60 minutes after generation.
60-day access window
Each export file remains accessible for 60 days, giving you a rolling historical window for analysis and auditing.
For a full list of available exports, see the exports overview.
Download complete export schema →
Export configurations are managed in the Integrations section of the admin console, accessible only to users with the Integrations role. While you can create and delete configurations through the console, daily data retrieval happens through the Recurly API — not the UI.
NoteMultiple configurations of the same export type are allowed. This is useful if you need different schedules or attribute sets for different destinations.
New versions of exports become available periodically. Recurly doesn't automatically update your existing configurations when a new version is released — you'll need to delete the outdated configuration and recreate it using the latest version. Check for updates regularly to make sure you're working with the most current data attributes.
Each export runs nightly and covers the full previous day's data for every selected export type, subject to any configured time-range filters. Only complete data sets are supported — you can't filter by subscription status or other partial criteria at export time. Those filters are available in the Exports UI but aren't reflected in Automated Exports output.
Retrieve your exports by polling the designated endpoint on the Recurly API using a private API key. A successful poll returns a secure, temporary URL pointing to the export file in its storage location. That URL is valid for 60 minutes, so download the file promptly after generating it.
TipPoll approximately two hours after the export run to make sure the data is ready. Polling too early may return a 404 — the file simply isn't available yet. Export files remain accessible for 60 days after creation.
1
Make sure the team members who need access to the Automated Exports UI have the Integrations role. For admin-level exports, they'll also need the Admin role.
2
In the Recurly admin console, select Integrations from the navigation panel to open the Automated Exports configuration area.
3
Add your export configurations — select the export types you need, set your schedule, and choose the relevant attributes. You can create multiple configurations of the same export type if needed.
4
When a new export version is released, delete the existing configuration and recreate it using the latest version. This is a manual step — Recurly won't update your configuration automatically.
5
Use your private API key to poll the designated Recurly API endpoint. The response includes a secure, time-limited URL to the export file. Poll approximately two hours after the nightly run to ensure the data is ready.
6
Use the temporary URL from the API response to download the export file. The URL is valid for 60 minutes. The file itself remains accessible via the API for 60 days after creation.
7
For ongoing operations, set up an automated job that polls the API on a schedule, downloads the export file, and loads it into your data warehouse. This removes the last remaining manual step and keeps your data fully in sync.
