Skip to main content

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.

​
Profile Lookup

Look up a contact’s behavioral profile by email address or LinkedIn URL. This endpoint is free and does not consume credits.

​
Endpoint

POST /public-profile-lookup

​
Request Body

FieldTypeRequiredDescription
emailstringOne requiredContact’s email address
linkedin_urlstringOne requiredContact’s LinkedIn profile URL
Provide either email or linkedin_url. If both are provided, email takes precedence.

​
Example Request

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"}'

​
Response

{
  "found": true,
  "profile": {
    "id": "uuid",
    "worldview_label": "Achievement-First",
    "operating_style_label": "The Dealmaker",
    "gem_tier": "gold",
    "tone_zone": "clear",
    "confidence": 0.72,
    "tone_summary": "Direct communicator who values efficiency and data-driven decisions."
  },
  "connection_language": {
    "must_do": "Lead with results and ROI; be concise and specific",
    "must_never": "Open with small talk before establishing credibility",
    "likes_this": "Data-backed claims with specific numbers",
    "not_that": "Vague promises without supporting evidence"
  },
  "relationship": {
    "tone_zone": "clear",
    "last_signal_at": "2026-04-01T10:30:00Z"
  }
}

​
Not Found Response

When the contact has not been profiled: 
{
  "found": false,
  "message": "Contact not found in the Behavioral Genome"
}