Implemented

Accounting, billing & payments

Recurly

Read and write Recurly accounts, subscriptions, plans, add-ons, items, coupons, measured units, usage and notes; read invoices, credit invoices, line items and transactions.

Synchronise Recurly subscribers, catalogue and usage with CRM, product and finance systems, and feed invoice and payment data into accounting.

Build a flow with Recurly Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

account notes

Create account note
Destination
Provider duplicate protection
Approval before production
Adds a note to an account.
account_notes.create
List notes of an account
Source
Notes of an account with cursor pagination.
account_notes.list

account subscriptions

List subscriptions of an account
Source
Incremental
Subscriptions of an account with cursor pagination, sorted by updated_at with begin_time for incremental reads.
account_subscriptions.list

accounts

Create account
Destination
Provider duplicate protection
Approval before production
Creates an account with contact details, address and custom fields. Billing info is never sent.
accounts.create
Get account
Source
One account by ID (Account ID or code-<account code>).
accounts.get
List accounts
Source
Incremental
Accounts with cursor pagination, sorted by updated_at with begin_time for incremental reads.
accounts.list
Update account
Destination
Provider duplicate protection
Approval before production
Updates supplied account fields.
accounts.update

coupons

Create coupon
Destination
Provider duplicate protection
Approval before production
Creates a single-code or bulk coupon with a fixed, percent or free-trial discount.
coupons.create
Get coupon
Source
One coupon by ID (Coupon ID or code-<coupon code>).
coupons.get
List coupons
Source
Incremental
Coupons with cursor pagination, sorted by updated_at with begin_time for incremental reads.
coupons.list
Update coupon
Destination
Provider duplicate protection
Approval before production
Updates the coupon fields Recurly allows to change after creation.
coupons.update

credit invoices

List credit invoices (credit notes)
Source
Incremental
Credit invoices (credit notes) with cursor pagination, sorted by updated_at with begin_time for incremental reads.
credit_invoices.list

credit payments

Get credit payment
Source
One credit payment by ID.
credit_payments.get
List credit payments (read only)
Source
Incremental
Credit payments (read only) with cursor pagination, sorted by updated_at with begin_time for incremental reads.
credit_payments.list

custom field definitions

List custom field definitions
Source
Incremental
Custom field definitions with cursor pagination, sorted by updated_at with begin_time for incremental reads.
custom_field_definitions.list

invoice line items

List line items of an invoice
Source
Incremental
Line items of an invoice with cursor pagination, sorted by updated_at with begin_time for incremental reads.
invoice_line_items.list

invoices

Get invoice
Source
One invoice by ID (Invoice ID or number-<invoice number>).
invoices.get
List invoices
Source
Incremental
Invoices with cursor pagination, sorted by updated_at with begin_time for incremental reads.
invoices.list
Update invoice details
Destination
Provider duplicate protection
Approval before production
Updates an invoice's PO number, notes, terms and net terms. Amounts are unchanged.
invoices.update

items

Create item
Destination
Provider duplicate protection
Approval before production
Creates a catalogue item with prices per currency.
items.create
Get item
Source
One item by ID (Item ID or code-<item code>).
items.get
List items
Source
Incremental
Items with cursor pagination, sorted by updated_at with begin_time for incremental reads.
items.list
Update item
Destination
Provider duplicate protection
Approval before production
Updates supplied item fields.
items.update

measured units

Create measured unit
Destination
Provider duplicate protection
Approval before production
Creates a measured unit for usage add-ons.
measured_units.create
List measured units
Source
Incremental
Measured units with cursor pagination, sorted by updated_at with begin_time for incremental reads.
measured_units.list
Update measured unit
Destination
Provider duplicate protection
Approval before production
Updates a measured unit.
measured_units.update

plan add ons

Create plan add-on
Destination
Provider duplicate protection
Approval before production
Creates a fixed or usage add-on on a plan.
plan_add_ons.create
Get plan add-on
Source
One plan add-on by ID (Add-on ID or code-<add-on code>).
plan_add_ons.get
List add-ons of a plan
Source
Incremental
Add-ons of a plan with cursor pagination, sorted by updated_at with begin_time for incremental reads.
plan_add_ons.list
Update plan add-on
Destination
Provider duplicate protection
Approval before production
Updates supplied add-on fields and prices.
plan_add_ons.update

plans

Create plan
Destination
Provider duplicate protection
Approval before production
Creates a plan with prices per currency, billing interval and trial.
plans.create
Get plan
Source
One plan by ID (Plan ID or code-<plan code>).
plans.get
List plans
Source
Incremental
Plans with cursor pagination, sorted by updated_at with begin_time for incremental reads.
plans.list
Update plan
Destination
Provider duplicate protection
Approval before production
Updates supplied plan fields and prices.
plans.update

subscriptions

Create subscription
Destination
Provider duplicate protection
Approval before production
Creates a subscription for an existing account and plan with manual (invoice) collection.
subscriptions.create
Get subscription
Source
One subscription by ID (Subscription ID or uuid-<uuid>).
subscriptions.get
List subscriptions
Source
Incremental
Subscriptions with cursor pagination, sorted by updated_at with begin_time for incremental reads.
subscriptions.list
Update subscription
Destination
Provider duplicate protection
Approval before production
Updates subscription terms, renewal settings, PO number, notes and custom fields. Plan, price and quantity changes are not included.
subscriptions.update

transactions

Get transaction
Source
One transaction by ID (Transaction ID or uuid-<uuid>).
transactions.get
List transactions (read only)
Source
Incremental
Transactions (read only) with cursor pagination, sorted by updated_at with begin_time for incremental reads.
transactions.list

usage

Record usage
Destination
Provider duplicate protection
Approval before production
Records usage against a usage add-on on a subscription.
usage.create
List usage records of a subscription add-on
Source
Usage records of a subscription add-on with cursor pagination.
usage.list

Authentication

Recurly private API key (HTTP Basic username)

Plans and access

API access is included on Recurly plans; keys are created per site. Private API keys grant full site access unless scoped in Recurly. Usage operations require usage-based add-ons on the site.

Test environment

Recurly sandbox sites use the same API hosts with sandbox API keys.

Rate limits

Sandbox sites allow 400 requests per minute and production sites 1,000 GET requests per minute over a sliding 5-minute window; Recurly returns HTTP 429 and Nexra backs off.

Pagination

limit (max 200) with has_more and next path; incremental reads use sort=updated_at and begin_time.

Provider events

Recurly webhook notifications for account, subscription, invoice and payment events. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Subscription create always sends collection_method=manual so Recurly issues an invoice with net terms instead of charging a stored payment method during the flow. Change collection in Recurly if automatic collection is required.
Subscription update covers terms, renewal, PO number, notes and custom fields; plan or quantity changes (subscription changes), next bill date and collection method changes are not automated.
Invoice create (which collects pending charges), purchases, pending line items, refunds, voids, invoice collection, cancellations, pauses, reactivation, billing info and account redaction are intentionally not automated.
Invoice update changes PO number, notes, terms and net terms only.
Coupon update supports the fields Recurly allows to change after creation; discount values cannot be edited.
Recurly v2021-02-25 is pinned with the Accept header.

Developer reference

Create the Recurly credentials described above with the narrowest permissions your flows need.
In Nexra, open Connect, then Connections, then New connection, choose Recurly, enter its settings and credentials, and tick only the write actions you need. Connection guide
Test the connection, then use its actions as flow sources and destinations. Flow guide

Recurly docsAPI reference Recurly docsAuthentication Recurly docsRate limits Recurly docsWebhooks

Machine-readable detail: GET /api/public/connect/connectors/recurly and the Connections API.