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

# Recurly

> Learn how to connect Recurly to Slicker

### Prerequisites

Slicker integrates with Recurly via an API key. Creating a Recurly API key requires a Recurly user with a role that has the `Integrations` permission.
If you are using the default roles, the `Site Admin` role has this permission already.

### Create credentials

1. Go to your Recurly dashboard and create an API key. This is under `Integrations -> API Credentials`.

   <Frame>
     <img src="https://mintcdn.com/slicker/HZZPLdXP1aKdz94r/images/integrations/recurly_api_creds_page.png?fit=max&auto=format&n=HZZPLdXP1aKdz94r&q=85&s=1cabba4a40f54ca5b0b8bd5c77b05546" alt="Recurly API credentials page" width="3022" height="1538" data-path="images/integrations/recurly_api_creds_page.png" />
   </Frame>

2. Click the `Add Private API Key` button. This will open a new page where you can configure the API Key.
   Add an appropriate name like `Slicker` and ensure the `Read-Only` checkbox is **not** selected.

   <Warning>If the credentials are read-only, Slicker will not be able to retry failed transactions and recover revenue. </Warning>

   It should look something like this.

   <Frame>
     <img src="https://mintcdn.com/slicker/HZZPLdXP1aKdz94r/images/integrations/recurly_private_api_keys_page.png?fit=max&auto=format&n=HZZPLdXP1aKdz94r&q=85&s=52e604aa43897ac4473678c8a37ab613" alt="Recurly Private API keys configuration page" width="3018" height="1552" data-path="images/integrations/recurly_private_api_keys_page.png" />
   </Frame>

3. Click `Save Changes` and copy the generated key.

### Create integration in Slicker

1. Go to the Slicker's [new integration page](https://app.slickerhq.com/integrations/new).
2. Select `Recurly` from the list of integrations.
3. Give the integration a name and description to help you identify it later.
4. Enter the API key you copied earlier.
5. Enter the Recurly dashboard URL for your Recurly instance - for example, `https://yourcompany.recurly.com`.
   This will be useful when you need to navigate to the Recurly dashboard from Slicker.
6. Click the `Submit` button to create the integration.

### Troubleshooting

On integration creation, Slicker will attempt to connect to Recurly using the provided API key.
If the connection fails, you will see an error message like the one below.
Please double-check the API key, make sure it has the correct permissions, and try again.

<Frame>
  <img src="https://mintcdn.com/slicker/HZZPLdXP1aKdz94r/images/integrations/integration-failure.png?fit=max&auto=format&n=HZZPLdXP1aKdz94r&q=85&s=59f6f532473345be5919699e5de59427" alt="Failed integration creation message" width="946" height="177" data-path="images/integrations/integration-failure.png" />
</Frame>