# Quickstart

Get up and running with the Ailyssa Integration API in minutes.

## Prerequisites

- An Ailyssa account with API access enabled
- Your API key (available from Settings > API Keys in the Ailyssa dashboard)


## Step 1: Authenticate

All API requests require a Bearer token in the `Authorization` header:


```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.ailyssa.com/v1/alerts
```

## Step 2: Make your first request

Retrieve recent alerts for your organization:


```bash
curl -X GET https://api.ailyssa.com/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

## Step 3: Create an alert

Push an alert from an external system:


```bash
curl -X POST https://api.ailyssa.com/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "camera_id": "cam_01",
    "use_case": "ppe_detection",
    "status": "open"
  }'
```

## Next steps

- Explore the full [API Reference](/apis)
- Learn about webhooks and automations (coming soon)