Skip to main content

Quickstart

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

1. Get Your API Key

1

Sign in to Skaala

Log in to your Skaala dashboard at skaala.ai
2

Navigate to API Settings

Go to SettingsAPI Keys
3

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"

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

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:

Need Help?