Skip to main content
POST
/
v1
/
kols
curl -X POST "https://api.medstrato.com/v1/kols" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "Dr. Michael Rodriguez",
    "title": "Director of Orthopedic Surgery",
    "institution": "Johns Hopkins Hospital",
    "department": "Orthopedics",
    "specialties": ["orthopedic_surgery", "sports_medicine"],
    "expertise_areas": ["knee_replacement", "robotic_surgery"],
    "tier": "tier_2",
    "email": "m.rodriguez@jhmi.edu",
    "location": {
      "city": "Baltimore",
      "state": "MD",
      "country": "US"
    },
    "tags": ["robotic_surgery", "potential_speaker"]
  }'

{
  "data": {
    "id": "kol_mno456",
    "full_name": "Dr. Michael Rodriguez",
    "title": "Director of Orthopedic Surgery",
    "institution": "Johns Hopkins Hospital",
    "department": "Orthopedics",
    "specialties": ["orthopedic_surgery", "sports_medicine"],
    "expertise_areas": ["knee_replacement", "robotic_surgery"],
    "tier": "tier_2",
    "engagement_level": "low",
    "email": "m.rodriguez@jhmi.edu",
    "location": {
      "city": "Baltimore",
      "state": "MD",
      "country": "US"
    },
    "tags": ["robotic_surgery", "potential_speaker"],
    "event_count": 0,
    "created_at": "2024-01-20T14:30:00Z",
    "updated_at": "2024-01-20T14:30:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.medstrato.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Request Body

​
full_name
string
required
Full name of the KOL
​
title
string
Professional title (e.g., “Chief of Cardiology”)
​
institution
string
Primary institution or hospital
​
department
string
Department within the institution
​
specialties
array
required
List of medical specialties
​
expertise_areas
array
Specific areas of expertise
​
research_interests
array
Research focus areas
​
tier
string
default:"tier_3"
KOL tier classification. Options: tier_1, tier_2, tier_3
​
email
string
Primary email address
​
phone
string
Phone number
​
location
object
​
bio
string
Professional biography
​
notes
string
Internal notes (not visible to KOL)
​
tags
array
Custom tags for organization
​
social
object

​
Response

Returns the created KOL object. 
curl -X POST "https://api.medstrato.com/v1/kols" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "Dr. Michael Rodriguez",
    "title": "Director of Orthopedic Surgery",
    "institution": "Johns Hopkins Hospital",
    "department": "Orthopedics",
    "specialties": ["orthopedic_surgery", "sports_medicine"],
    "expertise_areas": ["knee_replacement", "robotic_surgery"],
    "tier": "tier_2",
    "email": "m.rodriguez@jhmi.edu",
    "location": {
      "city": "Baltimore",
      "state": "MD",
      "country": "US"
    },
    "tags": ["robotic_surgery", "potential_speaker"]
  }'

{
  "data": {
    "id": "kol_mno456",
    "full_name": "Dr. Michael Rodriguez",
    "title": "Director of Orthopedic Surgery",
    "institution": "Johns Hopkins Hospital",
    "department": "Orthopedics",
    "specialties": ["orthopedic_surgery", "sports_medicine"],
    "expertise_areas": ["knee_replacement", "robotic_surgery"],
    "tier": "tier_2",
    "engagement_level": "low",
    "email": "m.rodriguez@jhmi.edu",
    "location": {
      "city": "Baltimore",
      "state": "MD",
      "country": "US"
    },
    "tags": ["robotic_surgery", "potential_speaker"],
    "event_count": 0,
    "created_at": "2024-01-20T14:30:00Z",
    "updated_at": "2024-01-20T14:30:00Z"
  }
}

​
Errors

CodeDescription
400Invalid request body or missing required fields
409KOL with this email already exists
429KOL limit reached for your plan