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

# Quickstart

> Get up and running with the Skaala API in minutes

# Quickstart

This guide will help you make your first API call to Skaala in under 5 minutes.

## 1. Get Your API Key

<Steps>
  <Step title="Sign in to Skaala">
    Log in to your Skaala dashboard at [skaala.ai](https://www.skaala.ai/dashboard)
  </Step>

  <Step title="Navigate to API Settings">
    Go to **Settings** → **API Keys**
  </Step>

  <Step title="Create API Key">
    Click **Create API Key** and copy your new key. It will look like `sk_live_abc123...`
  </Step>
</Steps>

<Warning>
  **Keep your API key secure!** Never share it publicly or commit it to version control.
  Use environment variables to store your key safely.
</Warning>

## 2. Make Your First Request

Let's list your bookings to verify everything is working:

<CodeGroup>
  ```bash cURL theme={null}
  curl https://www.skaala.ai/api/v1/bookings \
    -H "X-API-Key: sk_live_your_key_here"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://www.skaala.ai/api/v1/bookings', {
    headers: {
      'X-API-Key': process.env.SKAALA_API_KEY
    }
  });

  const { data, meta } = await response.json();
  console.log(`Found ${meta.total} bookings`);
  ```

  ```python Python theme={null}
  import requests
  import os

  response = requests.get(
      'https://www.skaala.ai/api/v1/bookings',
      headers={'X-API-Key': os.environ['SKAALA_API_KEY']}
  )

  data = response.json()
  print(f"Found {data['meta']['total']} bookings")
  ```

  ```php PHP theme={null}
  <?php
  $apiKey = getenv('SKAALA_API_KEY');

  $ch = curl_init('https://www.skaala.ai/api/v1/bookings');
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'X-API-Key: ' . $apiKey
  ]);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

  $response = curl_exec($ch);
  $data = json_decode($response, true);

  echo "Found {$data['meta']['total']} bookings\n";
  ?>
  ```
</CodeGroup>

## 3. Create a Booking

Now let's create a new booking:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://www.skaala.ai/api/v1/bookings \
    -H "X-API-Key: sk_live_your_key_here" \
    -H "Content-Type: application/json" \
    -d '{
      "service_id": "svc_abc123",
      "start_time": "2025-01-15T10:00:00Z",
      "contact": {
        "name": "Anna Svensson",
        "email": "anna@example.se",
        "phone": "+46701234567"
      },
      "notes": "First-time customer"
    }'
  ```

  ```javascript JavaScript theme={null}
  const booking = await fetch('https://www.skaala.ai/api/v1/bookings', {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.SKAALA_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      service_id: 'svc_abc123',
      start_time: '2025-01-15T10:00:00Z',
      contact: {
        name: 'Anna Svensson',
        email: 'anna@example.se',
        phone: '+46701234567'
      },
      notes: 'First-time customer'
    })
  });

  const { data } = await booking.json();
  console.log('Booking created:', data.id);
  ```

  ```python Python theme={null}
  import requests
  import os

  booking = requests.post(
      'https://www.skaala.ai/api/v1/bookings',
      headers={
          'X-API-Key': os.environ['SKAALA_API_KEY'],
          'Content-Type': 'application/json'
      },
      json={
          'service_id': 'svc_abc123',
          'start_time': '2025-01-15T10:00:00Z',
          'contact': {
              'name': 'Anna Svensson',
              'email': 'anna@example.se',
              'phone': '+46701234567'
          },
          'notes': 'First-time customer'
      }
  )

  data = booking.json()
  print(f"Booking created: {data['data']['id']}")
  ```
</CodeGroup>

## 4. Set Up Webhooks (Optional)

Get real-time notifications when events occur:

```bash theme={null}
curl -X POST https://www.skaala.ai/api/v1/webhooks \
  -H "X-API-Key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/skaala",
    "events": ["booking.created", "booking.cancelled", "call.completed"]
  }'
```

<Tip>
  See our [Webhooks Guide](/guides/webhooks) for detailed setup instructions and event types.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/getting-started/authentication">
    Learn about API keys and OAuth
  </Card>

  <Card title="Pagination" icon="list" href="/guides/pagination">
    Handle large result sets efficiently
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/guides/errors">
    Understand error codes and responses
  </Card>

  <Card title="Rate Limits" icon="gauge-high" href="/guides/rate-limits">
    Stay within API limits
  </Card>
</CardGroup>

## Common Use Cases

Explore these guides for specific integration scenarios:

* [Booking Flow](/guides/use-cases/booking-flow) - Build a complete booking system
* [Agent Configuration](/guides/use-cases/agent-configuration) - Set up voice AI agents
* [Call Handling](/guides/use-cases/call-handling) - Manage inbound calls

## Need Help?

* **API Reference**: Browse all endpoints and schemas
* **Support**: Email [support@skaala.ai](mailto:support@skaala.ai) or [contact us](https://www.skaala.ai/en/contact)
* **Dashboard**: Access your [API keys and settings](https://www.skaala.ai/dashboard)