Recurly · Authentication Profile
Recurly Authentication
Authentication
Recurly secures its APIs with http, apiKey, and oauth2 across 5 declared security schemes, as derived from its OpenAPI definitions.
SubscriptionBillingPaymentsRecurring RevenueInvoicingDunningRevenue RecognitionChurnMCPShopifyWebhook
Methods: http, apiKey, oauth2
Schemes: 5
OAuth flows:
API key in:
Security Schemes
bearer http
scheme: bearer
api_key http
scheme: basic
basicAuth http
scheme: basic
sec0 apiKey
· in: header ()
compass_mcp_oauth oauth2
· flows:
Source
Authentication Profile
generated: '2026-11-05'
method: searched
source: openapi/recurly-openapi.yml, openapi/recurly-v2-openapi.yml, openapi/recurly-recover-openapi.yml, openapi/recurly-commerce-openapi.yml,
openapi/recurly-revrec-openapi.yml, openapi/recurly-engage-openapi.yml ; https://docs.recurly.com/recurly-subscriptions/docs/api-keys
; https://docs.recurly.com/recurly-subscriptions/docs/webhooks ; https://oauth.recurly.com/.well-known/oauth-authorization-server
summary:
types:
- http
- apiKey
- oauth2
primary: HTTP Basic with a private API key as the username and an empty password (v3, v2, Recover, RevRec)
schemes:
- name: bearer
type: http
scheme: bearer
bearerFormat: JWT
sources:
- openapi/recurly-commerce-openapi.yml
apis:
- Recurly Commerce API
how: 'Authorization: Bearer <JWT> at https://subs.api.recurlycommerce.com (the spec declares bearerFormat JWT;
the token is issued from the Commerce admin).'
- name: api_key
type: http
scheme: basic
description: Enter the API key as the username and set the password to an empty string. You can locate and manage
your API keys from the [API Credentials](https://app.recurly.com/go/developer/api_keys) page.
sources:
- openapi/recurly-openapi.yml
- openapi/recurly-recover-openapi.yml
- openapi/recurly-v2-openapi.yml
apis:
- Recurly v3 API
- Recurly API v2 (legacy XML)
- Recurly Recover API
docs: https://docs.recurly.com/recurly-subscriptions/docs/api-keys
how: 'Authorization: Basic base64(<api_key>:) — "Enter the API key as the username and set the password to an
empty string"; keys are generated under Integrations → API Credentials by a user with the Integration permission,
one key per integration with a label, revoked with the user who created them.'
scope_note: API keys grant full access to your Recurly account (no scoped keys); v3 needs no subdomain because
the site is specified per request.
- name: basicAuth
type: http
scheme: basic
apis:
- Recurly RevRec API
sources:
- openapi/recurly-revrec-openapi.yml
description: Authentication scheme using Basic Auth where the API key is provided as the username and the password
is blank.
- name: sec0
type: apiKey
in: header
header: rf-app
apis:
- Recurly Engage Custom Rendering API
sources:
- openapi/recurly-engage-openapi.yml
description: Engage (Redfast) app key sent in the rf-app request header.
- name: compass_mcp_oauth
type: oauth2
apis:
- Recurly Compass MCP server
flows:
authorizationCode:
authorizationUrl: https://oauth.recurly.com/oauth2/authorize
tokenUrl: https://oauth.recurly.com/oauth2/token
refreshUrl: null
scopes:
mcp:tools: scopes_supported in the protected-resource metadata
metadata: https://oauth.recurly.com/.well-known/oauth-authorization-server
protected_resource_metadata: https://mcp.recurly.com/.well-known/oauth-protected-resource
registration: https://oauth.recurly.com/oauth2/register (dynamic client registration)
revocation: https://oauth.recurly.com/oauth2/revoke
notes: '"Log in to Recurly before connecting — the OAuth flow authenticates automatically. Tokens expire after
30 days, so you''ll reconnect periodically."'
docs: https://docs.recurly.com/recurly-subscriptions/docs/api-keys
name: Recurly authentication
webhooks:
auth: HTTP Basic Authentication configured per endpoint in the Admin UI
signature_header: recurly-signature (JSON payloads only)
ip_allowlist: https://docs.recurly.com/docs/ip-allowlist
Work with this as data
Every security artifact here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for security posture
4 MCP tools reach this
find_securityBrowse and filter every security artifact in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This security artifact
curl "https://apis.io/api/v1/security/recurly-authentication"
All security posture
curl "https://apis.io/api/v1/security?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.