# Caspio

How to set up and use Tray.io's Caspio connector

## Authentication

Caspio uses **OAuth 2.0 with client credentials** (Client ID and Client Secret) along with your account **Subdomain** to authenticate. You generate these credentials by creating a Web Services Profile inside your Caspio account.

### Prerequisites

* A Caspio account with permission to manage **Access permissions**
* A Tray.io account with permission to create authentications

### Step 1: Create a Web Services Profile in Caspio

1. Log in to your **Caspio account**
2. Click the **shield icon** in the top-right navigation bar
3. Select **Access permissions** from the dropdown

![Caspio top navigation showing the shield icon and Access permissions dropdown](https://tray.ai/documentation/images/connectors/service/caspio/caspio-access-permissions-menu.png)

4. Navigate to the **Web services profiles** tab
5. Click **Create web services profile**

![Access permissions page showing the Web services profiles tab and Create web services profile button](https://tray.ai/documentation/images/connectors/service/caspio/caspio-web-services-profiles.png)

6. Fill in the **Profile name** and **Email address** (required fields) — you can leave everything else as default
7. Under **Access**, your **Client ID** and **Client secret** are automatically generated — copy both values
8. Click **Create**

![New web services profile form showing the Client ID, Client secret, and permissions fields](https://tray.ai/documentation/images/connectors/service/caspio/caspio-create-profile-form.png)

> **Info:** Your **Subdomain** is the unique part of your Caspio account URL. For example, if your Caspio URL is `b3poa.caspio.com`, your subdomain is `b3poa`.

### Step 2: Add the Caspio Connector in Tray and Open Authentication

1. Add the **Caspio** connector to your workflow
2. Click on the connector step to open the properties panel
3. Go to the **Authentication** tab
4. Click **Create new authentication**

![Caspio connector Authentication tab showing the Create new authentication button](https://tray.ai/documentation/images/connectors/service/caspio/tray-auth-tab-empty.png)

### Step 3: Enter Your Credentials

On step **2 of 2** of the new authentication modal, enter the credentials from your Caspio web services profile:

* **Client ID** — copied from the Access section of the profile
* **Client secret** — copied from the Access section of the profile
* **Subdomain** — the account-specific part of your Caspio URL (e.g. `b3poa`)

Then click **Create authentication**.

![New authentication form showing the Client ID, Client secret, and Subdomain fields](https://tray.ai/documentation/images/connectors/service/caspio/tray-auth-credentials-form.png)

***

## Testing Your Connection

Once authenticated, run a simple operation to confirm the connection is working. If the step returns data successfully, your Caspio authentication is set up correctly.