Recurly Connector
Prerequisites
- A Recurly account (any plan)
- Admin access to generate API credentials
Getting Your Credentials
Recurly uses a Private API Key for authentication.
- Log into the Recurly Dashboard
- Go to Integrations > API Credentials
- Copy your Private API Key
If you need to generate a new key, click Generate New Private API Key. Note that generating a new key invalidates the previous one.
Choosing a Region
Recurly operates in two regions:
- US (default):
https://v3.recurly.com - EU:
https://v3.eu.recurly.com
Select the region that matches where your Recurly site is hosted.
Configuration in Landed
| Field | Value |
|---|---|
| API Key | Your Recurly private API key |
| Region | us (default) or eu |
Available Streams
| Stream | Description | Sync Mode |
|---|---|---|
accounts | Customer accounts with billing address, status | Incremental |
subscriptions | Subscription records with plan, state, dates | Incremental |
invoices | Invoice records with line items and totals | Incremental |
transactions | Payment transactions | Incremental |
plans | Subscription plan definitions | Incremental |
line_items | Individual line items from invoices | Incremental |
add_ons | Plan add-on definitions | Incremental |
coupons | Discount coupon records | Incremental |
credit_payments | Credit payment records | Incremental |
items | Item catalog entries | Incremental |
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
401 Unauthorized | Invalid API key | Generate a new key in Recurly > Integrations > API Credentials |
403 Forbidden | Insufficient permissions | Ensure you are using an admin-level API key |
| Wrong data returned | Incorrect region | Switch region from us to eu (or vice versa) to match your Recurly site |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically |
Static IPs for Allowlisting
If your Recurly configuration requires IP allowlisting:
- Production:
34.170.185.84,35.192.90.94 - Staging:
34.171.93.34