Skip to main content
All CollectionsSemble FAQS Integrations
Integrating with Top Doctors
Integrating with Top Doctors

Integrating with Topdoctors

Cindy avatar
Written by Cindy
Updated over 4 months ago

Integrating Top Doctors with Semble

Integrating your TopDoctors account with Semble allows you to streamline your online booking process, ensuring that appointments are efficiently managed between both platforms. Below is a step-by-step guide on how to set up this integration and click here for a full video on what this integration offers end to end.


Step 1: Create a Role for Top Doctors

  1. Create a New Role:

    • In Semble, navigate to the roles section.

    • Create a new role titled Top Doctor.

    • Ensure that this role has access to See/Edit Patients and Booking features.


Step 2: Select Clinicians, Room, and Products

In the "integrations" tab in your settings please go to the Top Doctors integrations settings:

  1. Assign Clinicians:

  2. Choose the Room:

    • Choose the room(s) where these appointments will take place.

    • Ensure that the room availability matches the clinicians' schedules.

  3. Select Products:

    • Choose the specific services or products that will be available for booking through Top Doctors.

4. Click on "Save access details to Top Doctors", you should see a confirmation popping up on the top right corner of your screen.

NB: Ensure that your clinicians' and rooms' availabilities are correctly set up and synced with Top Doctors. Incorrect availability settings could lead to double bookings or unavailable slots being offered to patients. More information on how to check this can be found here.


Step 3: Send Access Details to Top Doctors

  1. API Token Creation:

    • Once you have set up the above, Semble will automatically generate an API token. This can be found in your "API Access" tab:

  2. Access Details:

    • Within a few days, you should receive an email from Top Doctors with further instructions. Share the necessary access details with Top Doctors, including the API credentials required for integration.

NB: Be cautious when managing your API token. Deleting the API token will disrupt the integration with Top Doctors, requiring you to set it up again from scratch.


Booking System Considerations

When using Top Doctors for online booking, available appointment times are displayed in 15-minute intervals.

If a longer appointment is required, such as a 45-minute session, you will need to book three consecutive 15-minute slots on Top Doctors. Unlike Semble, where you can book a single 45-minute appointment directly, Top Doctors will require you to book these multiple slots manually to reflect the longer appointment.

For example, if you book a 45-minute appointment on Semble, it will appear as three consecutive 15-minute slots on Top Doctors. If you are booking directly on Top Doctors and need a 45-minute appointment, you must select three 15-minute slots to ensure the full duration is reserved.

Did this answer your question?