Quickstart

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

1. Get Your API Key

Navigate to API Settings

Go to Settings → API Keys

Create API Key

Click Create API Key and copy your new key. It will look like sk_live_abc123...

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

2. Make Your First Request

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

curl https://www.skaala.ai/api/v1/bookings \
  -H "X-API-Key: sk_live_your_key_here"

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`);

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
$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";
?>

3. Create a Booking

Now let’s create a new booking:

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"
  }'

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);

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']}")

4. Set Up Webhooks (Optional)

Get real-time notifications when events occur:

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"]
  }'

See our Webhooks Guide for detailed setup instructions and event types.

Next Steps

Authentication

Learn about API keys and OAuth

Pagination

Handle large result sets efficiently

Error Handling

Understand error codes and responses

Rate Limits

Stay within API limits

Common Use Cases

Explore these guides for specific integration scenarios:

Booking Flow - Build a complete booking system
Agent Configuration - Set up voice AI agents
Call Handling - Manage inbound calls

Need Help?

API Reference: Browse all endpoints and schemas
Support: Email support@skaala.ai or contact us
Dashboard: Access your API keys and settings

​Quickstart

​1. Get Your API Key

​2. Make Your First Request

​3. Create a Booking

​4. Set Up Webhooks (Optional)

​Next Steps

Authentication

Pagination

Error Handling

Rate Limits

​Common Use Cases

​Need Help?

Quickstart

1. Get Your API Key

2. Make Your First Request

3. Create a Booking

4. Set Up Webhooks (Optional)

Next Steps

Common Use Cases

Need Help?