Automated exports

Schedule and retrieve nightly data exports from Recurly to keep your data warehouse in sync without logging into the admin console.

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.

Not included in Starter or Pro — contact [email protected] or your CSM to upgrade

1Definition 2Key benefits 3Key details 4Set up automated exports

Prerequisites

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.

Limitations

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.

Definition

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.

Key benefits

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.

Key details

For a full list of available exports, see the exports overview.

Download complete export schema →

Configuration

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.

Export versions

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.

Data availability

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.

Accessing the data

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.

Set up automated exports

Assign user roles

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.

Navigate to Integrations

In the Recurly admin console, select Integrations from the navigation panel to open the Automated Exports configuration area.

Configure your exports

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.

Keep versions current

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.

Retrieve exports via the API

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.

Download the exported data

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.

Automate retrieval

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.

Updated about 1 month ago

Did this page help you?