Skip to main content
Telara

Integrations / Recurly

Recurly logo

Recurly

Recurly subscription billing and revenue management platform for accounts, plans, subscriptions, invoices, transactions, and coupons.

Basic auth
Indexes
Actions

What Telara does

Capability matrix

Before you connect

Prerequisites

A Recurly site you can administer.
Admin who can copy the private API key.

Vendor setup

Get the credential

1
Open API credentials
In Recurly, go to Integrations → API Credentials.
2
Copy the private key
Copy the Private API Key (not the public key). Recurly uses HTTP Basic: the key is the username and the password is empty.
3
Paste in Telara
Settings → Integrations → Recurly. Paste the private API key. Leave password blank or use a placeholder if the form requires it.

In Telara

Connect in Telara

Basic auth

Recurly API key over HTTP Basic Auth. Use the API key as the username and leave the password blank (or any placeholder value — it is ignored). Confirmed against the spec's components.securitySchemes.api_key entry, which declares type http and scheme basic — not a bearer/header token scheme, despite the "api_key" name. Same shape as this catalog's dropbox_sign.yaml connector; see that file's auth block for the identical pattern. Keys are managed from the site's API Credentials page.

In Telara, open Settings → Integrations, choose this connector, and enter the username and password (or key) Telara asks for.

Fields Telara asks for
  • API key
  • Password

Knowledge

What gets indexed

ResourceCoverage
AccountPartial — not every record the vendor holds is synced
InvoicePartial — not every record the vendor holds is synced

Sync

Freshness & sync

ResourceLagDeletions
AccountUp to 1 hourRemoved records disappear when Telara next reconciles that resource
InvoiceUp to 1 hourRemoved records disappear when Telara next reconciles that resource

Data handling

Permissions & data handling

Telara has not published a permission list for this connector yet. Treat the vendor consent screen as the source of truth until this page lists scopes.

Excluded from semantic search: Account, Invoice.

After connect

Verify it worked

After you save, Telara runs a read-only check against the account. The integration shows as connected when that check succeeds.

Honesty

Known limitations

Sandbox and production Recurly sites are different keys.
The public key is for checkout.js. Telara needs the private API key.