Recurly · AsyncAPI Specification
Recurly Webhooks
Version
View Spec
View on GitHub
SubscriptionBillingPaymentsRecurring RevenueInvoicingDunningRevenue RecognitionChurnMCPShopifyWebhookAsyncAPIEvents
AsyncAPI Specification
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.
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.