Bot MDAPI Documentation
← Back to API Docs
Integration Guide

Bot MD API Integration

This documentation describes the API endpoints that your scheduling system must provide to enable Bot MD to manage appointments on behalf of your patients.

Important: You Are the API Provider

The endpoints documented here are APIs that you must implement and expose for Bot MD to consume. Bot MD acts as the client that calls your APIs to fetch availability, create appointments, and manage patient records.

How the Integration Works

1

You Provide the APIs

Your scheduling system exposes RESTful API endpoints for patient lookup, availability checking, and appointment management.

2

Bot MD Consumes Your APIs

When patients interact with Bot MD via chat (Messenger, Viber, SMS), Bot MD calls your APIs to check availability, book appointments, and manage schedules.

3

You Send Webhooks to Bot MD

When appointments are created, modified, or canceled in your system (e.g., by admin staff), you send webhook notifications to Bot MD's webhook URL so we can notify patients.

Authentication

Your API should use HTTP Basic Authentication. You will provide Bot MD with:

  • A unique USER_ID for each facility
  • A corresponding API_KEY for authentication
# Bot MD will call your API like this:
curl -u PROVIDER_USER_ID:PROVIDER_API_KEY \
  "https://api.provider.example/v1/calendars"

Required API Endpoints

Your scheduling system must implement the following endpoints for Bot MD to consume:

GET/api/v1/calendarsList available calendars/providers
GET/api/v1/patientLook up patient by name, DOB, phone
GET/api/v1/availabilityGet available time slots
POST/api/v1/appointmentsCreate a new appointment
GET/api/v1/appointmentsList appointments for a patient
PUT/api/v1/appointments/:id/rescheduleReschedule an appointment
PUT/api/v1/appointments/:id/cancelCancel an appointment
View detailed endpoint specifications

Webhook Integration

When events occur in your scheduling system (appointments created by staff, patient check-ins, etc.), you must send webhooks to Bot MD's webhook URL so we can notify patients.

Bot MD Webhook URL: Provided during integration setup (e.g., https://webhook.botmd.io/your-integration-id)

Required webhook events:

  • • appointmentCreated - When an appointment is booked
  • • appointmentRescheduled - When an appointment time changes
  • • appointmentCanceled - When an appointment is cancelled
  • • patientCreated - When a permanent patient ID is assigned
  • • Queued - When a patient checks in (includes queue number)

Next Steps

API Reference

View detailed endpoint specifications, request/response formats, and code examples.

Integration Flows

See step-by-step user journeys showing how Bot MD interacts with your system.

API Explorer

Test API endpoints with mock responses to understand expected behavior.

Contact Support

Need help with integration? Reach out to your Bot MD integration specialist.