Skip to main content

​
Quickstart

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

​
Step 1: Get Your API Key

  1. Sign in to YourWave
  2. Navigate to Developer Portal
  3. Click Create API Key
  4. Copy your key and store it securely
Your API key grants access to your organization’s behavioral data. Never expose it in client-side code, public repositories, or browser requests.

​
Step 2: Make Your First Request

Look up a contact’s behavioral profile using their email address: 
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"}'

​
Step 3: Read the Response

A successful response returns the contact’s behavioral profile: 
{
  "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?

Core Concepts

Understand the ToneMap methodology and Behavioral Genome.

API Reference

Explore all endpoints in detail.