Recurly · AsyncAPI Specification

Recurly Webhooks

Version

View Spec View on GitHub SubscriptionBillingPaymentsRecurring RevenueInvoicingDunningRevenue RecognitionChurnMCPShopifyWebhookAsyncAPIEvents

AsyncAPI Specification

Raw ↑
generated: '2026-11-05'
method: searched
name: Recurly webhooks
source: https://docs.recurly.com/recurly-subscriptions/docs/webhooks ; https://docs.recurly.com/recurly-subscriptions/docs/overview-webhooks
  ; asyncapi.yml (event catalogue compiled from the docs.recurly.com notification pages)
asyncapi_shipped_by_provider: false
asyncapi_document: asyncapi.yml (AsyncAPI 2.6.0 written by API Evangelist from the webhook reference; Recurly publishes
  no AsyncAPI)
docs: https://docs.recurly.com/recurly-subscriptions/docs/overview-webhooks
delivery:
  transport: HTTP POST to one or more endpoints configured per site in the Admin UI (webhooks cannot be configured
    via API)
  payload_formats:
  - JSON
  - XML
  format_rule: Each webhook endpoint can be configured to receive JSON or XML payloads — not both.
  authentication: HTTP Basic Authentication on the receiving endpoint, plus the published IP allowlist (https://docs.recurly.com/docs/ip-allowlist)
  signature:
    header: recurly-signature
    applies_to: JSON payloads only
    statement: For JSON payloads, Recurly signs each notification and includes the signature in a recurly-signature
      request header.
  retries:
    max_attempts: 10
    schedule: 10 + x * 2^(x+5) seconds, where x is the current attempt number
    statement: If Recurly receives an error in response to a webhook, the notification is retried. After ten failed
      attempts, Recurly stops sending that notification.
    manual: Individual notifications can be retried from the Admin Console; bulk retry of paused or failed notifications
      via Webhook Actions.
  storage: Each webhook notification is stored for 15 days and is accessible through the Admin Console, which also
    shows failure reasons.
  timestamps: UTC
  subscription_model: Notification types are opted into per endpoint.
  scale_claim: 650M Webhooks a month (recurly.com/pricing)
events:
- account/new
- account/updated
- account/canceled
- account/billing-info-updated
- account/shipping-address/new
- account/shipping-address/updated
- account/shipping-address/deleted
- subscription/new
- subscription/updated
- subscription/canceled
- subscription/expired
- subscription/renewed
- subscription/reactivated
- subscription/paused
- subscription/resumed
- subscription/scheduled-pause
- subscription/scheduled-update
- subscription/pause-modified
- subscription/paused-renewal
- subscription/pause-canceled
- subscription/prerenewal
- invoice/charge/new
- invoice/charge/processing
- invoice/charge/past-due
- invoice/charge/paid
- invoice/charge/failed
- invoice/charge/reopened
- invoice/charge/updated
- invoice/credit/new
- invoice/credit/processing
- invoice/credit/closed
- invoice/credit/voided
- invoice/credit/reopened
- invoice/credit/open
- invoice/credit/updated
- invoice/legacy/new
- invoice/legacy/pending
- invoice/legacy/processing
- invoice/legacy/closed
- invoice/legacy/past-due
- payment/scheduled
- payment/processing
- payment/successful
- payment/failed
- payment/refund-successful
- payment/void
- payment/fraud-info-updated
- payment/transaction-status-updated
- payment/transaction-authorized
- credit-payment/new
- credit-payment/voided
- dunning/event
- gift-card/purchased
- gift-card/canceled
- gift-card/updated
- gift-card/regenerated
- gift-card/redeemed
- gift-card/balance-updated
- gift-card/low-balance
- usage/new
- item/new
- item/updated
- item/deactivated
- item/reactivated
- external-subscription/new
- external-subscription/renewed
- external-subscription/canceled
- external-subscription/downgraded
- external-subscription/upgraded
- external-subscription/expired
- external-subscription/extended-renewal
- external-subscription/renewal-failure
- external-subscription/renewal-failure-with-grace-period
- external-subscription/reactivated
- external-subscription/resubscribed
- external-subscription/refunded
- external-subscription/refund-declined
- external-subscription/refund-reversed
- external-subscription/paused
- external-subscription/revoked
- external-subscription/recovered
- external-subscription/price-change-confirmed
- external-subscription/pause-schedule-changed
- external-subscription/voided
- external-subscription/plan-changed
- external-subscription/downgrade-canceled
- external-subscription/consumption-requested
event_count: 87
event_groups:
  account/new: 1
  account/updated: 1
  account/canceled: 1
  account/billing-info-updated: 1
  account/shipping-address/new: 1
  account/shipping-address/updated: 1
  account/shipping-address/deleted: 1
  subscription/new: 1
  subscription/updated: 1
  subscription/canceled: 1
  subscription/expired: 1
  subscription/renewed: 1
  subscription/reactivated: 1
  subscription/paused: 1
  subscription/resumed: 1
  subscription/scheduled-pause: 1
  subscription/scheduled-update: 1
  subscription/pause-modified: 1
  subscription/paused-renewal: 1
  subscription/pause-canceled: 1
  subscription/prerenewal: 1
  invoice/charge/new: 1
  invoice/charge/processing: 1
  invoice/charge/past-due: 1
  invoice/charge/paid: 1
  invoice/charge/failed: 1
  invoice/charge/reopened: 1
  invoice/charge/updated: 1
  invoice/credit/new: 1
  invoice/credit/processing: 1
  invoice/credit/closed: 1
  invoice/credit/voided: 1
  invoice/credit/reopened: 1
  invoice/credit/open: 1
  invoice/credit/updated: 1
  invoice/legacy/new: 1
  invoice/legacy/pending: 1
  invoice/legacy/processing: 1
  invoice/legacy/closed: 1
  invoice/legacy/past-due: 1
  payment/scheduled: 1
  payment/processing: 1
  payment/successful: 1
  payment/failed: 1
  payment/refund-successful: 1
  payment/void: 1
  payment/fraud-info-updated: 1
  payment/transaction-status-updated: 1
  payment/transaction-authorized: 1
  credit-payment/new: 1
  credit-payment/voided: 1
  dunning/event: 1
  gift-card/purchased: 1
  gift-card/canceled: 1
  gift-card/updated: 1
  gift-card/regenerated: 1
  gift-card/redeemed: 1
  gift-card/balance-updated: 1
  gift-card/low-balance: 1
  usage/new: 1
  item/new: 1
  item/updated: 1
  item/deactivated: 1
  item/reactivated: 1
  external-subscription/new: 1
  external-subscription/renewed: 1
  external-subscription/canceled: 1
  external-subscription/downgraded: 1
  external-subscription/upgraded: 1
  external-subscription/expired: 1
  external-subscription/extended-renewal: 1
  external-subscription/renewal-failure: 1
  external-subscription/renewal-failure-with-grace-period: 1
  external-subscription/reactivated: 1
  external-subscription/resubscribed: 1
  external-subscription/refunded: 1
  external-subscription/refund-declined: 1
  external-subscription/refund-reversed: 1
  external-subscription/paused: 1
  external-subscription/revoked: 1
  external-subscription/recovered: 1
  external-subscription/price-change-confirmed: 1
  external-subscription/pause-schedule-changed: 1
  external-subscription/voided: 1
  external-subscription/plan-changed: 1
  external-subscription/downgrade-canceled: 1
  external-subscription/consumption-requested: 1
note: Event names are the XML root elements documented per notification page on docs.recurly.com (new_account_notification,
  paid_charge_invoice_notification, ...); the JSON payloads carry the same event names.

Work with this as data

Every AsyncAPI spec 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 asyncapi

4 MCP tools reach this
  • find_asyncapisBrowse and filter every AsyncAPI spec 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 AsyncAPI spec
curl "https://apis.io/api/v1/asyncapis/recurly-webhooks"
All asyncapi
curl "https://apis.io/api/v1/asyncapis?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.