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

# Quickstart

> Connect your Meta Ads account and get your first AI diagnostic in under 5 minutes

# Quickstart

This guide walks you through getting access, connecting your Meta Business account, running your first diagnostic, and making your first API call.

## Step 1: Request access

KlayrAI is available by invitation. To get started:

1. Go to [klayrai.com](https://www.klayrai.com) and submit a **Request Demo** form
2. Our team will review your application and reach out within 24-48 hours
3. Once approved, you'll receive a sign-in link and credentials via email

<Note>
  KlayrAI uses Firebase Authentication. Your password is never stored on our servers — it's handled entirely by Google's auth infrastructure.
</Note>

## Step 2: Connect your Meta Business account

After signing in at [app.klayrai.com/sign-in](https://app.klayrai.com/sign-in), you'll land on the onboarding flow:

1. Click **Connect Meta Account**
2. Authorize KlayrAI in the Meta OAuth dialog (read-only permissions)
3. Select the ad accounts you want to monitor
4. Click **Continue**

<Warning>
  You must have **Admin** or **Advertiser** access on the Meta ad account to connect it. If you don't see an account, check your permissions in Meta Business Manager.
</Warning>

KlayrAI will begin syncing your campaign data. This typically takes 30-60 seconds for accounts with fewer than 100 campaigns.

## Step 3: Run your first diagnostic

Once syncing completes, you'll see your campaigns on the dashboard.

1. Navigate to the **Campaigns** page
2. Click on any campaign
3. Click the **Run Diagnostic** button
4. Wait approximately 5-10 seconds for the AI analysis

You'll receive:

* A plain-language summary of campaign performance
* Risk-scored issues (if any are detected)
* 1-3 prioritized recommendations

## Step 4: Get an API key (Agency plan)

If you're on the **Agency** plan, you can access the full KlayrAI API.

1. Go to **Settings** in the dashboard sidebar
2. Navigate to the **API Keys** section
3. Click **Create API Key**
4. Copy and store the key securely — it won't be shown again

<Warning>
  Treat your API key like a password. Do not commit it to version control or expose it in client-side code.
</Warning>

## Step 5: Make your first API call

With your API key, you can interact with KlayrAI programmatically.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.klayrai.com/v1/campaigns" \
    -H "x-api-key: your_api_key_here" \
    -H "klayrai-version: 2026-03-01" \
    -H "Content-Type: application/json"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.klayrai.com/v1/campaigns", {
    method: "GET",
    headers: {
      "x-api-key": "your_api_key_here",
      "klayrai-version": "2026-03-01",
      "Content-Type": "application/json",
    },
  });

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

You should receive a JSON response listing your connected campaigns:

```json theme={null}
{
  "data": [
    {
      "id": "camp_abc123",
      "metaCampaignId": "23851234567890",
      "name": "Summer Sale 2026 - TOF",
      "status": "ACTIVE",
      "objective": "CONVERSIONS",
      "dailyBudget": 150.00,
      "currency": "EUR",
      "createdAt": "2026-03-10T08:00:00Z"
    }
  ],
  "pagination": {
    "total": 12,
    "page": 1,
    "page_size": 20,
    "hasMore": false
  }
}
```

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Learn about API key management, versioning, and security best practices.
  </Card>

  <Card title="Run a diagnostic via API" icon="stethoscope" href="/api-reference/diagnostics">
    Trigger diagnostics programmatically and integrate results into your workflow.
  </Card>

  <Card title="Diagnostic Engine" icon="brain" href="/concepts/diagnostic-engine">
    Understand how the AI engine analyzes your campaigns.
  </Card>

  <Card title="Andromeda" icon="user-gear" href="/concepts/andromeda">
    Learn how KlayrAI adapts to your decision-making style.
  </Card>
</CardGroup>