API Integration (Advanced)

Bookable appointments can be queried and directly booked via the open API endpoints of the Consumer Booking API. Since only publicly bookable appointments are available here, no authentication is required.

To create full integrations via the timum Partner API, please contact our service: https://www.timum.de/read/service

Basic Information - Important

The booking calendar "Provider" is specified by its UUID: Find Provider UUID

Bookable resources (advisors, properties, objects) are referenced via specific identifiers from CRM systems or via timum UUIDs: Find or create references

Appointment booking via the open timum API follows a typical request sequence.

Filter Appointment Types (Optional)

It is also possible to query the list of appointment types offered and filter the available appointments by appointment type, if you specify appointment type-specific time slots: Endpoint POST list active products

Query Bookable Appointments

Query available bookable appointments: Endpoint GET upcoming bookables

Reserve Selected Time Slot

Once a customer has pre-selected an appointment, reserve this appointment for 3 minutes first, so that the appointment cannot be booked by someone else while the customer is entering their details: Endpoint POST reserve appointment

Finally Book Appointment with Customer Data

After the customer has provided all required details, book the appointment with customer data: POST create appointment with consumer

Example

(coming soon)