Morf’s direct scheduling links allow you to create a custom booking page for your patients. This page displays available time slots for a specific provider in a Provider Profile View, enabling patients to select a time that suits them.

To create a custom scheduling link that shows the correct availability for your patients, start with the base scheduling URL:

https://questions.morf.health/schedule/provider-profile

Then, add the following parameters to customize the link:

Required Parameters

  1. morfOrgId
    The Morf Organization ID. You can find this in your admin dashboard or contact us for assistance.

  2. schedulingApplication
    The scheduling application you’re using to manage provider availability. Choose either HEALTHIE or ACUITY.

  3. providerId
    The ID for the provider in your scheduling application (e.g., “224404” for Healthie).

  4. patientId
    This ID helps Morf identify the patient. If you’re using Formsort, we can use the responder UUID to uniquely identify the patient profile. If scheduling for an existing patient, include their Morf UUID (this is your main profile ID, which is reflected in the morf admin dashboard as the “customer” ID). If you’re unsure where to find this, let us know, and we can guide you.

If any required parameter is missing or invalid, an error message will appear on the screen. If you’re unsure why this is happening, you can send us the Request ID, and we’ll help you debug the issue.

Example

Here’s an example of how to add all the parameters to your scheduling URL:

https://questions.morf.health/schedule/provider-profile?morfOrgId={{morfOrgId}}&schedulingApplication={{schedulingApplication}}&providerId={{providerId}}&appointmentTypeId={{appointmentTypeId}}&patientId={{responder_UUID}}

Example of our test morf organization link:

https://questions.morf.health/schedule/provider-profile?morfOrgId=16a53f42-687c-4eb1-bd8b-27126485a7b7&schedulingApplication=HEALTHIE&providerId=224404&appointmentTypeId=172084

Scheduling Appointment

Currently, when the patient selects a desired time slot and clicks Confirm, the time slot details are returned as follows:

  • Formsort: The time_slot answer is set.
  • Iframe - Web: The time slot message is sent to the parent window.
  • Iframe - React Native: The time slot message is sent to the ReactNativeWebView.

If you’re using Formsort, you can utilize an API variable to call the Schedule Appointment endpoint, as all the necessary data is now included in the response. More in the corresponding section