> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recurly

> Connect Recurly to your Atako agents — 11 read and 7 write actions.

Let your agents run your Recurly subscription billing — read accounts, plans, subscriptions, invoices, transactions and coupons, create accounts and subscriptions, cancel, pause or reactivate a subscription, and add one-off charges or credits.

## Connection

* **Authentication**: API key (Private API key).
* **Required settings**:
  * **Region** — v3.eu for a site hosted in the EU, v3 otherwise (US).

<Note>
  Recurly → Integrations → API Credentials → Add Private API Key. Name it (e.g. "Atako"), save, then copy the private key. The key only works on the site it was created in — use a sandbox site to try things out. Region: v3 for a site hosted in the US, v3.eu for a site hosted in the EU.

  See [Recurly's documentation](https://app.recurly.com/go/developer/api_keys).
</Note>

## Read actions (11)

| Action                  | Description                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| `get_account`           | Fetch an account (contact details, address, state, billing info summary).                                     |
| `get_invoice`           | Fetch an invoice with its line items, totals, balance and payments.                                           |
| `get_plan`              | Fetch a plan with its pricing per currency, interval and trial settings.                                      |
| `get_subscription`      | Fetch a subscription: plan, account, state, quantity, current period and renewal dates.                       |
| `list_account_invoices` | List one account’s invoices, optionally by state or type.                                                     |
| `list_accounts`         | List the site’s customer accounts, newest first, optionally filtered by email, subscriber or past-due status. |
| `list_coupons`          | List the site’s coupons (code, discount, state, redemption limits).                                           |
| `list_invoices`         | List the site’s invoices, optionally by state (paid, past\_due, open…) or type (charge, credit).              |
| `list_plans`            | List the site’s plans (code, name, billing interval, currencies, trial).                                      |
| `list_subscriptions`    | List the site’s subscriptions, optionally by state (live = active + in\_trial + canceled-not-yet-expired).    |
| `list_transactions`     | List the site’s payment transactions (purchases, payments, refunds…), optionally successful ones only.        |

## Write actions (7)

| Action                    | Description                                                                                                                                                                |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cancel_subscription`     | Cancel a subscription: it keeps running until the end of the term (or next bill date) then expires. Reversible with reactivate\_subscription until then.                   |
| `create_account`          | Create a customer account. `code` is your own unique identifier and cannot be changed later. No payment details.                                                           |
| `create_line_item`        | Add a one-off charge or credit to an account; it stays pending and is billed on the next invoice. unit\_amount is a decimal in the currency unit.                          |
| `create_subscription`     | Subscribe an account to a plan. The account is found by code or created with the details given; it must already hold a payment method unless collection\_method is manual. |
| `pause_subscription`      | Pause a subscription for a number of billing cycles from its next renewal; 0 cancels a pending pause.                                                                      |
| `reactivate_subscription` | Bring a canceled (not yet expired) subscription back to an active, renewing state on its original billing cycle.                                                           |
| `update_account`          | Update an account’s contact details, locale, address or tax settings. Only the fields sent change.                                                                         |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*