Skip to main content
POST
/
v1
/
events
curl -X POST "https://api.medstrato.com/v1/events" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q2 Orthopedics Advisory Board",
    "description": "Quarterly meeting to discuss robotic surgery trends",
    "event_type": "advisory_board",
    "start_date": "2024-06-20T09:00:00Z",
    "end_date": "2024-06-20T17:00:00Z",
    "location": {
      "type": "in_person",
      "venue": "Four Seasons Hotel",
      "city": "Boston",
      "country": "US"
    },
    "visibility": "invite_only",
    "attendees": ["kol_abc123", "kol_def456"]
  }'

const event = await medstrato.events.create({
  name: 'Q2 Orthopedics Advisory Board',
  description: 'Quarterly meeting to discuss robotic surgery trends',
  event_type: 'advisory_board',
  start_date: '2024-06-20T09:00:00Z',
  end_date: '2024-06-20T17:00:00Z',
  location: {
    type: 'in_person',
    venue: 'Four Seasons Hotel',
    city: 'Boston',
    country: 'US'
  },
  visibility: 'invite_only',
  attendees: ['kol_abc123', 'kol_def456']
});

{
  "data": {
    "id": "evt_new123",
    "name": "Q2 Orthopedics Advisory Board",
    "description": "Quarterly meeting to discuss robotic surgery trends",
    "event_type": "advisory_board",
    "status": "draft",
    "start_date": "2024-06-20T09:00:00Z",
    "end_date": "2024-06-20T17:00:00Z",
    "location": {
      "type": "in_person",
      "venue": "Four Seasons Hotel",
      "city": "Boston",
      "country": "US"
    },
    "visibility": "invite_only",
    "attendee_count": 2,
    "rsvp_stats": {
      "confirmed": 0,
      "pending": 2,
      "declined": 0
    },
    "created_at": "2024-01-20T14:30:00Z",
    "updated_at": "2024-01-20T14:30:00Z"
  }
}

​
Request Body

​
name
string
required
Event name
​
description
string
Event description
​
event_type
string
required
Type of event. Options: advisory_board, speaker_program, conference, workshop, webinar, dinner, other
​
start_date
string
required
Start date and time (ISO 8601)
​
end_date
string
required
End date and time (ISO 8601)
​
location
object
​
visibility
string
default:"organization"
Event visibility. Options: private, organization, invite_only
​
agenda
array
​
attendees
array
List of KOL IDs to invite

​
Response

Returns the created event object. 
curl -X POST "https://api.medstrato.com/v1/events" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q2 Orthopedics Advisory Board",
    "description": "Quarterly meeting to discuss robotic surgery trends",
    "event_type": "advisory_board",
    "start_date": "2024-06-20T09:00:00Z",
    "end_date": "2024-06-20T17:00:00Z",
    "location": {
      "type": "in_person",
      "venue": "Four Seasons Hotel",
      "city": "Boston",
      "country": "US"
    },
    "visibility": "invite_only",
    "attendees": ["kol_abc123", "kol_def456"]
  }'

const event = await medstrato.events.create({
  name: 'Q2 Orthopedics Advisory Board',
  description: 'Quarterly meeting to discuss robotic surgery trends',
  event_type: 'advisory_board',
  start_date: '2024-06-20T09:00:00Z',
  end_date: '2024-06-20T17:00:00Z',
  location: {
    type: 'in_person',
    venue: 'Four Seasons Hotel',
    city: 'Boston',
    country: 'US'
  },
  visibility: 'invite_only',
  attendees: ['kol_abc123', 'kol_def456']
});

{
  "data": {
    "id": "evt_new123",
    "name": "Q2 Orthopedics Advisory Board",
    "description": "Quarterly meeting to discuss robotic surgery trends",
    "event_type": "advisory_board",
    "status": "draft",
    "start_date": "2024-06-20T09:00:00Z",
    "end_date": "2024-06-20T17:00:00Z",
    "location": {
      "type": "in_person",
      "venue": "Four Seasons Hotel",
      "city": "Boston",
      "country": "US"
    },
    "visibility": "invite_only",
    "attendee_count": 2,
    "rsvp_stats": {
      "confirmed": 0,
      "pending": 2,
      "declined": 0
    },
    "created_at": "2024-01-20T14:30:00Z",
    "updated_at": "2024-01-20T14:30:00Z"
  }
}