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

# Xano Integration

> Connect HelloLeo to your Xano backend API

Connect HelloLeo to your Xano instance to interact with your backend APIs, databases, and services.

## Setup

1. Go to **Project Settings** → **Project Integrations**
2. Select **Xano** from the list
3. Enter your credentials:
   * **API Key** - Your Xano API key
     * Get it from [Xano Account Settings](https://app.xano.com/account?mode=master)
   * **Instance** - Select your Xano instance (populated automatically after entering API key)
   * **Workspace** - Select your Xano workspace (populated automatically after selecting instance)
4. Test the connection
5. Start using Xano in your prompts

## How It Works

HelloLeo connects to your Xano instance using the Xano API. Your API key is encrypted and stored securely on the backend. The integration supports dynamic instance and workspace selection to help you connect to the right Xano environment.

## Environment Variables

When you configure Xano, the following environment variables are automatically set up:

* `VITE_XANO_API_URL` - Your Xano API URL

## Common Operations

Xano provides a flexible backend API platform. You can:

* **Query databases** - Access your Xano database tables
* **Call functions** - Execute Xano functions and workflows
* **Manage data** - Create, read, update, and delete records
* **Handle authentication** - Use Xano's built-in auth features

## Example Usage

### Display Data

```
Show all users from my Xano database. Display name, email, 
and registration date.
```

### Create Records

```
Create a new record in my Xano "Products" table with name 
"Widget", price 29.99, and category "Electronics".
```

### Call Functions

```
Execute my Xano function "calculateTotal" with parameters 
quantity: 5 and price: 10.
```

### Update Records

```
Update the product with ID 123 in Xano to set the price 
to 39.99.
```

## Best Practices

* **Specify endpoints** - Tell Leo which Xano endpoint or function you want to use
* **Mention the integration** - Always say "from Xano" or "to Xano" so Leo knows which integration to use
* **Use environment variables** - Reference `VITE_XANO_API_URL` in your code to connect to your Xano instance
* **Test endpoints** - Verify your Xano endpoints work before using them in production

## Troubleshooting

### Connection Issues

* **Check API key** - Verify your Xano API key is correct
* **Instance selection** - Make sure you've selected the correct instance
* **Workspace selection** - Ensure you've selected the correct workspace
* **API key permissions** - Verify your API key has access to the instances and workspaces you need

### Data Not Showing

* **Check endpoint** - Verify you're using the correct Xano endpoint URL
* **API permissions** - Ensure your API key has read access
* **Endpoint configuration** - Verify the endpoint is properly configured in Xano

### Can't Create/Update

* **Write permissions** - Ensure your API key has write access
* **Endpoint settings** - Check that the endpoint allows POST/PATCH/PUT requests
* **Required fields** - Make sure all required fields are provided
* **Data format** - Verify data matches your Xano table schema

<CardGroup cols={2}>
  <Card title="Working with Integrations" icon="plug" href="/integrations/working-with-integrations">
    Learn how to use integrations effectively
  </Card>

  <Card title="Network Monitor" icon="activity" href="/features/network-monitor">
    Debug Xano API calls
  </Card>
</CardGroup>