> ## 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.

# Piano

> Learn how to connect Piano to Slicker

### Prerequisites

Slicker integrates with Piano via the [Piano API](https://docs.piano.io/api). To connect Piano to Slicker, you will need:

* An **API Token** with sufficient permissions to manage subscriptions and payments.
* Your **Application ID (aid)**, which uniquely identifies your Piano application.
* Your **Piano API URL**, which depends on your Piano environment (e.g., sandbox vs production).

Only Piano users with administrator-level access can create API tokens.

### Create credentials

1. Log in to your Piano dashboard.

2. Navigate to the API tokens section to generate a new API token.

3. Give the token a descriptive name like `Slicker`.

4. Copy the generated **API Token**. We will need it later.

5. Note your **Application ID (aid)**. You can find this in your Piano dashboard settings.

6. Note your **API URL**. This is the base URL for your Piano environment. For example:
   * Production: `https://api.piano.io`
   * Sandbox: `https://sandbox.piano.io`

### Create integration in Slicker

1. Go to the Slicker's [new integration page](https://app.slickerhq.com/integrations/new).
2. Select `Piano` from the list of integrations.
3. Give the integration a name and description to help you identify it later.
4. Enter the **API Token** you copied earlier.
5. Enter your **Application ID (aid)**.
6. Enter your **API URL**.
7. Click the `Submit` button to create the integration.

### Troubleshooting

On integration creation, Slicker will attempt to connect to Piano using the provided credentials.
If the connection fails, you will see an error message like the one below.
Please double-check the API token, Application ID, and URL, then 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>
