Skip to main content

MechanicDesk Online Booking Integration

Andrew

MechanicDesk provides two methods for adding online booking functionality to your website:

  1. Embed the default booking form using an iframe (simplest setup).

  2. Integrate using the API to submit booking requests from a custom form.

This document explains both options and how they can be implemented.

1. Embedding the Default Booking Form (Iframe)

MechanicDesk includes a built-in booking form that can be embedded directly into your website using an iframe. This is the quickest way to enable online bookings without requiring custom development.

Setup Steps

  1. Log into your MechanicDesk account.

  2. Navigate to:

Settings → Workshop Details → Online Booking

  1. Enable Online Booking.

  2. Copy the iframe code snippet provided.

  3. Paste the snippet into the page on your website where you want the booking form to appear.

Example:

<iframe src='https://www.mechanicdesk.com.au/online-booking/abcdefghijklmnopqrstuvwxyz' width='100%' height='100%' frameBorder='0'></iframe>

Once embedded, the booking form will appear inside your webpage and allow customers to submit booking requests directly from your site.

2. API Integration

For websites that require a custom booking interface or deeper system integration, MechanicDesk provides an API that allows booking requests to be created programmatically.

2.1 Create a Booking Request

Send a POST request to the following endpoint:

POST https://www.mechanicdesk.com.au/booking_requests/create_booking

This endpoint creates a booking request in MechanicDesk.

The request payload must include booking information along with a secret token that identifies your workshop.

Secret Token

The secret token can be found in your MechanicDesk account under:

Settings → Workshop Details → Online Booking

You will see a code snippet similar to the iframe example below:

<iframe src='https://www.mechanicdesk.com.au/online-booking/abcdefghijklmnopqrstuvwxyz' width='100%' height='100%' frameBorder='0'></iframe>

The token is the string at the end of the URL:

abcdefghijklmnopqrstuvwxyz

This token must be included in the API request payload.

Accepted Payload Attributes

The following attributes may be submitted when creating a booking request.

Authentication

  • token – Secret workshop token (required)

Customer Information

  • name – Customer full name

  • first_name – Customer first name

  • last_name – Customer last name

  • phone – Customer phone number

  • email – Customer email address

  • street_line – Street address

  • suburb – Suburb

  • state – State

  • postcode – Postcode

Vehicle Information

  • registration_number – Vehicle registration number

  • make – Vehicle make

  • model – Vehicle model

  • year – Vehicle year

  • color – Vehicle colour

  • transmission – Transmission type

  • vin – Vehicle VIN number

  • fuel_type – Fuel type

  • drive_type – Drive type

  • engine_size – Engine size

  • body – Vehicle body type

  • odometer – Vehicle odometer reading

Booking Information

  • drop_off_time – Vehicle drop-off time

  • pickup_time – Vehicle pickup time

  • job_type_names – Array of job type names requested

  • courtesy_vehicle_requested – true or false

  • note – Additional notes from the customer

  • repco_smart_quote_id – Quote request key used for Repco Punchout

Important:
All date and time values must follow the format:

dd/mm/yyyy HH:MM

2.2 Retrieve Available Job Types

To allow customers to select services when making a booking, your form can retrieve available job types using the following endpoint:

GET https://www.mechanicdesk.com.au/booking_requests/available_job_types?token=abcdefghijklmnopqrstuvwxyz

This endpoint returns the list of valid job type titles configured in MechanicDesk.

Your booking form can display these options and submit the selected values using the job_type_names field when creating the booking request.

Job types returned by the API can be controlled within MechanicDesk, allowing you to hide internal or administrative job types from the booking form.

2.3 Retrieve Unavailable Days

To prevent bookings on days when your workshop is unavailable, the booking form can retrieve unavailable dates from the MechanicDesk diary.

Use the following endpoint:

GET https://www.mechanicdesk.com.au/booking_requests/unavailable_days?token=abcdefghijklmnopqrstuvwxyz

This endpoint returns the dates that should be disabled in the booking calendar.

Lookahead Range

By default, the endpoint returns unavailable dates for the next 30 days.

You can change the lookahead period using the in_days parameter. The allowed range is 1 to 90 days.

Example:

Retrieve unavailable days for the next 60 days.

GET https://www.mechanicdesk.com.au/booking_requests/unavailable_days?token=abcdefghijklmnopqrstuvwxyz&in_days=60

This allows your booking form to dynamically block unavailable dates in the calendar.

Powered by Zendesk