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

Raw ↑
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.
All 92 tools →

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.