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

# Quickstart

> Start using the AI CSR API in under 5 minutes

## Get Your API Key

<Steps>
  <Step title="Sign Up">
    Create your account at [YOUR\_DEPLOYMENT.lupitor.com](https://YOUR_DEPLOYMENT.lupitor.com)
  </Step>

  <Step title="Navigate to API Keys">
    Go to your company's API Keys page in the dashboard
  </Step>

  <Step title="Create New Key">
    Click "Create API Key" and choose the appropriate scope:

    * **Read**: View leads and conversations
    * **Write**: Create and manage leads (includes read access)
  </Step>

  <Step title="Save Your Key">
    Copy your API key immediately - it won't be shown again!
  </Step>
</Steps>

<Warning>
  Store your API key securely. Never commit it to version control or share it publicly.
</Warning>

## Make Your First Request

Let's create a lead for your campaign:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://YOUR_DEPLOYMENT.lupitor.com/api/v1/leads \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "campaignId": "your_campaign_id",
      "phoneNumber": "+15555551234",
      "metadata": {
        "name": "John Doe",
        "company": "Acme Corp"
      }
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://YOUR_DEPLOYMENT.lupitor.com/api/v1/leads', {
    method: 'POST',
    headers: {
      'x-api-key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      campaignId: 'your_campaign_id',
      phoneNumber: '+15555551234',
      metadata: {
        name: 'John Doe',
        company: 'Acme Corp'
      }
    })
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://YOUR_DEPLOYMENT.lupitor.com/api/v1/leads',
      headers={
          'x-api-key': 'YOUR_API_KEY',
          'Content-Type': 'application/json'
      },
      json={
          'campaignId': 'your_campaign_id',
          'phoneNumber': '+15555551234',
          'metadata': {
              'name': 'John Doe',
              'company': 'Acme Corp'
          }
      }
  )

  print(response.json())
  ```
</CodeGroup>

## Expected Response

```json theme={null}
{
  "success": true,
  "data": {
    "leadId": "jh7abc123xyz"
  },
  "error": null
}
```

<Check>
  **Congratulations!** You've successfully created your first lead via the API.
</Check>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Learn about API key scopes and security
  </Card>

  <Card title="Create Leads" icon="plus" href="/api-reference/leads/create">
    Explore the full lead creation API
  </Card>

  <Card title="Bulk Import" icon="upload" href="/api-reference/leads/bulk-create">
    Import multiple leads at once
  </Card>

  <Card title="List Leads" icon="list" href="/api-reference/leads/list">
    Query and filter your leads
  </Card>
</CardGroup>