Skip to main content

Fetch Round Robin Availability and Book a Slot

Overview​

This guide demonstrates how to use the meetergo API to fetch availability for a host or round robin queue and book an available slot. This integration provides a battle-tested scheduling API for your product while your team manages appointments through the meetergo UI.

Use Case: Create a custom booking form on your website with seamless appointment integration and no third-party branding.

Prerequisites​

  • A meetergo account with admin access
  • API access credentials

Implementation​

Step 1: Set up meeting type​

  1. Log in to the meetergo UI
  2. Create a team (if none exists)
    • Go to Team Settings via the gear icon
    • Teams function as workspaces to group configurations
    • Set a team name and adjust the team slug (used in outward-facing links)
  3. Create a meeting type
    • Go to "Meeting types" via the calendar icon
    • Click "New" and select your team
    • Configure settings or adjust them later
    • Ensure the meeting type is active
  4. Get the meeting type ID from the URL 
    /meeting-types/edit/1c89cd41-b2e9-21as-d9sx-b0axs284962/general
  5. Fetch meeting type details with an authenticated request 
    GET https://api.meetergo.com/meeting-type/<your meeting type ID>
  6. Note the queueId from the response for the next step

Step 2: Retrieve Availability​

When a user visits your application, fetch available time slots:

GET /booking-availability/v2?queueId=<your queue ID>&meetingTypeId=<your meeting type id>&start=<ISO formatted time>&end=<ISO formatted time>

Response example:

{
  "timezone": "utc",
  "timeframes": [
    { "start": "2023-10-09T08:00:00.000Z", "end": "2023-10-09T10:00:00.000Z" },
    { "start": "2023-10-09T11:00:00.000Z", "end": "2023-10-09T12:00:00.000Z" },
    { "start": "2023-10-10T08:00:00.000Z", "end": "2023-10-10T10:00:00.000Z" }
  ]
}

Display these timeframes to users as available slots.

Step 3: Make a booking​

When a user selects a time slot, make a booking with:

POST /booking

Request body:

{
  "attendee": {
    "email": "claudia@meetergo.com",
    "firstname": "Claudia",
    "lastname": "B",
    "fullname": "Claudia B",
    "receiveReminders": true,
    "bringalongEmails": [],
    "notes": {
      "field1": "value1"
    },
    "phone": "+490",
    "language": "de",
    "timezone": "Europe/Berlin",
    "dataPolicyAccepted": true
  },
  "meetingTypeId": "<Your meeting type ID>",
  "start": "2023-10-09T08:00:00.000Z",
  "locationId": 0,
  "queueId": "<Your queue ID>",
  "channel": "connect",
  "duration": 30
}

A successful request returns a 201 Created response. Show a success message to the user. The slot will be synced to the host's calendar, and any configured notifications or workflows will be triggered.

Support​

If you need assistance, contact our support team.