API Integration (Advanced)

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

For full integrations via the timum Partner API, please contact our service team: +49 (0)30 41765984 or via www.timum.de.

Basic information – important

The provider calendar ("Provider") is specified via its UUID: Find provider UUID

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

Booking an appointment via the open timum API follows a typical request sequence:

1. Filter appointment types (optional)

Optionally, you can query the list of offered appointment types in advance and filter the available appointments by appointment type – useful if you want to specify appointment-type-specific time ranges: endpoint POST list active products

2. Query bookable appointments

Query available bookable appointments: endpoint GET upcoming bookables

3. Reserve the selected time slot

As soon as a customer has pre-selected an appointment, reserve it first for 3 minutes so that it cannot be booked by someone else while the customer data is being entered: endpoint POST reserve appointment

4. Book the appointment with customer data

Once all required information has been provided, book the appointment with the customer data: POST create appointment with consumer