Advanced Analytica Advanced Analytica: IBOM
← All connectors
Recurly logo

Source connector

Recurly

Set up Recurly as a source and move its data into your chosen destination.

Version 1.3.71 community alpha

Recurly

Use this guide to set up the Recurly source connector and find reference information. The connector reads data from the Recurly v3 API (version v2021-02-25).

Prerequisites

  • A Recurly site
  • A Recurly user whose role includes the Integration permission, allowing you to view API credentials
  • A private API key for the site you want to sync

Set up the connector

1. Get a Recurly API key

  1. Sign in to Recurly as a user with the Integration permission.
  2. Go to Integrations > API Credentials.
  3. Copy an existing private API key, or add a new private key for Airbyte.

A dedicated Airbyte key lets you revoke access without affecting other integrations. Recurly private API keys grant full access to your site’s data. Recurly doesn’t offer read-only keys. For more information, see Recurly API keys.

2. Set up Recurly in Airbyte

  1. In Airbyte, go to Sources and add a new source. Select Recurly.
  2. For API Key, paste the private API key from Step 1.
  3. (Optional) For Start Date, enter the replication start date and time in UTC, using YYYY-MM-DDTHH:mm:ssZ. If you leave it empty, the connector replicates the last five years of data.
  4. (Optional) For End Date, enter the replication end date and time in UTC, using YYYY-MM-DDTHH:mm:ssZ. The connector won’t replicate records updated after this time. If you leave it empty, the connector replicates data up to the sync time.
  5. (Optional) For Number of concurrent threads, enter how many requests the connector sends to Recurly in parallel, from 1 to 20. The default is 10.
  6. (Optional) For Days in length for each API call to get data, enter how many days the connector requests from the accounts stream at once, from 1 to 365. The default is 30. Smaller values make more API calls but improve concurrency.
  7. (Optional) Turn on Use Sandbox Environment if the API key belongs to a Recurly sandbox site. Sandbox sites have a lower rate limit than production sites.
  8. Click Set up source.

Supported sync modes

The Recurly source connector supports these sync modes:

  • Full Refresh
  • Incremental

All streams except Export Dates support incremental syncs. Most streams use updated_at as the cursor. The Account Notes stream uses created_at.

Supported streams

Some streams can take longer to sync on sites with many accounts because they make one request per account. These streams are Account Coupon Redemptions, Account Notes, Billing Infos and Shipping Addresses.

Limits and troubleshooting

Rate limits

Recurly limits API requests over a sliding five-minute window. Production sites allow 5,000 GET requests by default, while sandbox sites allow 2,000 requests. The connector paces requests within the limit for the site type you select with Use Sandbox Environment. See Recurly API limits.

Recurly applies the limit across the whole site, while the connector tracks only its own requests. The connector can still receive HTTP 429 responses if other connections or integrations use the same Recurly site. It retries rate-limited responses and server errors up to five times, using exponential backoff.

Authentication errors

The sync fails with a configuration error if Recurly returns HTTP 401 or 403. Check that the API key is an active private key for the site you want to sync. Then update the API Key field.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
1.3.712026-11-1091303Pace requests to Recurly’s published rate limits, retry rate-limited and server error responses with exponential backoff, show actionable API key errors, and accept start and end dates saved without the trailing Z
1.3.702026-11-1091708Update dependencies
1.3.692026-11-0390721Update dependencies
1.3.682026-10-2089408Update dependencies
1.3.672026-10-1388767Update dependencies
1.3.662026-10-0688013Update dependencies
1.3.652026-09-2987315Update dependencies
1.3.642026-09-2286794Update dependencies
1.3.632026-09-1586212Update dependencies
1.3.622026-09-0885632Update dependencies
1.3.612026-08-1884729Update dependencies
1.3.602026-08-1184098Update dependencies
1.3.592026-07-2883194Update to CDK 7.23.8 (fixes AirbyteCustomCodeNotPermittedError for bundled custom components) and remove the temporary Cloud version override
1.3.582026-07-281082Roll Cloud back to 1.3.56 — 1.3.57 is built on SDM 7.23.7, which breaks bundled custom components
1.3.572026-07-2883069Update dependencies
1.3.562026-07-2182560Update dependencies
1.3.552026-07-1481973Update dependencies
1.3.542026-06-3081209Update dependencies
1.3.532026-06-2380563Update dependencies
1.3.522026-06-1680005Update dependencies
1.3.512026-06-0979468Update dependencies
1.3.502026-06-0278924Update dependencies
1.3.492026-04-2877376Update dependencies
1.3.482026-04-2176720Update dependencies
1.3.472026-04-1376276Rename “concurrent workers” to “concurrent threads” in connector spec
1.3.462026-03-2475379Update dependencies
1.3.452026-03-1074639Update dependencies
1.3.442026-03-0373886Update dependencies
1.3.432026-02-1773522Update dependencies
1.3.422026-02-0372656Update dependencies
1.3.412026-01-2072016Update dependencies
1.3.402026-01-1471471Update dependencies
1.3.392025-12-1870642Update dependencies
1.3.382025-11-2570003Update dependencies
1.3.372025-11-1869622Update dependencies
1.3.362025-10-2968903Update dependencies
1.3.352025-10-2168341Update dependencies
1.3.342025-10-1467882Update dependencies
1.3.332025-10-0867545Update dependencies
1.3.322025-09-3066434Update dependencies
1.3.312025-09-0965702Update dependencies
1.3.302025-08-2465439Update dependencies
1.3.292025-08-1664996Update dependencies
1.3.282025-08-0364476Update dependencies
1.3.272025-07-2063657Update dependencies
1.3.262025-07-0763356Update Schema and add configurable concurrency
1.3.252025-07-0562679Update dependencies
1.3.242025-06-2861292Update dependencies
1.3.232025-06-2346722Fixes timestamp pattern for UI to match what connector expects
1.3.222025-05-2460470Update dependencies
1.3.212025-05-1060117Update dependencies
1.3.202025-05-0359488Update dependencies
1.3.192025-04-2759059Update dependencies
1.3.182025-04-1958512Update dependencies
1.3.172025-04-1257862Update dependencies
1.3.162025-04-0557342Update dependencies
1.3.152025-03-2956797Update dependencies
1.3.142025-03-2256238Update dependencies
1.3.132025-03-0855054Update dependencies
1.3.122025-02-2354550Update dependencies
1.3.112025-02-1554010Update dependencies
1.3.102025-02-0853507Update dependencies
1.3.92025-02-0152982Update dependencies
1.3.82025-01-2552493Update dependencies
1.3.72025-01-1851864Update dependencies
1.3.62025-01-1151351Update dependencies
1.3.52024-12-2850684Update dependencies
1.3.42024-12-2150289Update dependencies
1.3.32024-12-1449718Update dependencies
1.3.22024-12-1249333Update dependencies
1.3.12024-12-1149091Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
1.3.02024-11-1348474Remove definition and schema redundancy, update to latest CDK and make compatibility with builder
1.2.02024-11-0447290Migrate to manifest only format
1.1.132024-11-0448248Update dependencies
1.1.122024-10-2847067Update dependencies
1.1.112024-10-1246829Update dependencies
1.1.102024-10-0546456Update dependencies
1.1.92024-09-2846140Update dependencies
1.1.82024-09-2145764Update dependencies
1.1.72024-09-1445471Update dependencies
1.1.62024-09-0745274Update dependencies
1.1.52024-08-3145050Update dependencies
1.1.42024-08-2444742Update dependencies
1.1.32024-08-1744210Update dependencies
1.1.22024-08-1043472Update dependencies
1.1.12024-08-0343144Update dependencies
1.1.02024-07-2440729Migrate connector to low code
1.0.122024-07-2042206Update dependencies
1.0.112024-07-1341836Update dependencies
1.0.102024-07-1041500Update dependencies
1.0.92024-07-0941174Update dependencies
1.0.82024-07-0640820Update dependencies
1.0.72024-06-2740215Replaced deprecated AirbyteLogger with logging.Logger
1.0.62024-06-2540474Update dependencies
1.0.52024-06-2240012Update dependencies
1.0.42024-06-0639178[autopull] Upgrade base image to v1.2.2
1.0.32024-04-1937246Updating to 0.80.0 CDK
1.0.22024-04-1237246schema descriptions
1.0.12024-03-0535828Bump version to unarchive supportLevel in Cloud productionDB
1.0.02024-03-0135763Re-introduce updated connector to catalog from archival repo
0.5.02024-02-2234622Republish connector using base image/Poetry, update schemas
0.4.12022-06-1013685Add state_checkpoint_interval to Recurly stream
0.4.02022-01-289866Revamp Recurly Schema and add more resources
0.3.22022-01-208617Update connector fields title/description
0.3.12022-01-109382Source Recurly: avoid loading all accounts when importing account coupon redemptions
0.3.02021-12-088468Support Incremental Sync Mode
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.