Skip to main content

​
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 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
KlayrAI uses Firebase Authentication. Your password is never stored on our servers — it’s handled entirely by Google’s auth infrastructure.

​
Step 2: Connect your Meta Business account

After signing in at 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
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.
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
Treat your API key like a password. Do not commit it to version control or expose it in client-side code.

​
Step 5: Make your first API call

With your API key, you can interact with KlayrAI programmatically. 
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"
You should receive a JSON response listing your connected campaigns: 
{
  "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

Authentication

Learn about API key management, versioning, and security best practices.

Run a diagnostic via API

Trigger diagnostics programmatically and integrate results into your workflow.

Diagnostic Engine

Understand how the AI engine analyzes your campaigns.

Andromeda

Learn how KlayrAI adapts to your decision-making style.