Create subscriptions and configure dunning in Recurly

domain: recurly · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Authenticate by including your Recurly private API key in the 'Authorization' header as 'Basic {base64(api_key:)}'; generate API keys in Recurly Admin Console > Integrations > API Credentials.
  2. Base URL is https://v3.recurly.com; all requests must include 'Accept: application/vnd.recurly.v2021-02-25' (or current version date) and 'Content-Type: application/json' headers.
  3. Create an account first by POSTing to /accounts with 'code' (your unique identifier for the customer), 'email', 'first_name', and 'last_name'; the account must exist before creating a subscription.
  4. Create a subscription by POSTing to /subscriptions with 'plan_code' (referencing a plan configured in Recurly), 'account' object (with 'code' referencing the account), and 'currency'; include 'billing_info' with payment method details or a token from Recurly.js.
  5. Configure dunning in Recurly Admin Console > Settings > Dunning Management — define retry schedules per payment method type (credit card, ACH, PayPal); dunning configuration is UI-based and does not require API calls for the schedule itself.
  6. Monitor failed payments and dunning status via webhooks; configure endpoint URLs in Admin Console > Integrations > Webhooks for events like 'failed_payment_notification' and 'subscription_expired_notification'.

Known gotchas

Related routes

Configure Recurly dunning campaigns and intelligent retries for failed subscription renewals
recurly.com · 6 steps · unrated
Create a Recurly subscription add-on and charge variable quantities at renewal
recurly.com · 5 steps · unrated
Create a Recurly subscription plan and enroll a subscriber via the Recurly v3 API
recurly.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans