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

# Quickstart

> Make your first CoreTone API request in under 5 minutes.

# Quickstart

Get up and running with the CoreTone API in three steps.

## Step 1: Get Your API Key

1. Sign in to [YourWave](https://yourwave.ai/app/developer)
2. Navigate to **Developer Portal**
3. Click **Create API Key**
4. Copy your key and store it securely

<Warning>
  Your API key grants access to your organization's behavioral data. Never expose it in client-side code, public repositories, or browser requests.
</Warning>

## Step 2: Make Your First Request

Look up a contact's behavioral profile using their email address:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    https://yeoffsnpsacsnxphsokr.supabase.co/functions/v1/public-profile-lookup \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"email": "jane@example.com"}'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://yeoffsnpsacsnxphsokr.supabase.co/functions/v1/public-profile-lookup",
    {
      method: "POST",
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ email: "jane@example.com" }),
    }
  );
  const profile = await response.json();
  ```

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

  response = requests.post(
      "https://yeoffsnpsacsnxphsokr.supabase.co/functions/v1/public-profile-lookup",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json={"email": "jane@example.com"},
  )
  profile = response.json()
  ```
</CodeGroup>

## Step 3: Read the Response

A successful response returns the contact's behavioral profile:

```json theme={null}
{
  "found": true,
  "profile": {
    "worldview_label": "Achievement-First",
    "operating_style_label": "The Dealmaker",
    "gem_tier": "gold",
    "tone_zone": "clear",
    "confidence": 0.72
  },
  "connection_language": {
    "must_do": "Lead with results and ROI",
    "must_never": "Open with small talk before establishing credibility",
    "likes_this": "Data-backed claims with specific numbers",
    "not_that": "Vague promises without evidence"
  }
}
```

## What's Next?

<CardGroup cols={2}>
  <Card title="Core Concepts" icon="lightbulb" href="/guides/concepts">
    Understand the ToneMap methodology and Behavioral Genome.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore all endpoints in detail.
  </Card>
</CardGroup>