Superhostem.cz
Integration format

Superhostem ICS format

Use this iCalendar profile when an external system needs to import reservations directly into Superhostem. It is stricter than ordinary blocking calendars because each event must carry a stable external reservation id and guest contact details.

This format is used to import your ICS reservation data into Superhostem, including external IDs, guest contact details, dates, guest count, and optional reservation price.

Superhostem ICS is authoritative. When an event with the same external ID changes, Superhostem updates the existing reservation. When the event is marked deleted, Superhostem soft-cancels the reservation. External IDs must never be reused.

Full iCalendar example
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Your System//Superhostem ICS 1.0//EN
X-SUPERHOSTEM-FORMAT:1
BEGIN:VEVENT
UID:booking-123@example.com
X-SUPERHOSTEM-EXTERNAL-ID:booking-123
DTSTART;VALUE=DATE:20260901
DTEND;VALUE=DATE:20260905
SUMMARY:Jane Doe
DESCRIPTION:External ID: booking-123\nPrimary guest name: Jane Doe\nPrimary guest email: jane@example.com\nPrimary guest phone: +420777111222\nGuests: 2\nTotal price: 12500\nCurrency: CZK
END:VEVENT
END:VCALENDAR

Required event fields

UID
Valid iCalendar UID.
X-SUPERHOSTEM-EXTERNAL-ID
Mandatory unique reservation id. It must be stable across syncs and unique within the feed.
DTSTART;VALUE=DATE
Check-in date in YYYYMMDD format. If you send DATE-TIME instead of VALUE=DATE, include either a Z UTC suffix or TZID, for example DTSTART;TZID=Europe/Prague:20260901T150000.
DTEND;VALUE=DATE
Check-out date in YYYYMMDD format. If you send DATE-TIME instead of VALUE=DATE, include either a Z UTC suffix or TZID, for example DTEND;TZID=Europe/Prague:20260905T100000.
SUMMARY
Short human-readable title. Superhostem uses the primary guest name from DESCRIPTION for reservation data.

Description fields

Primary guest name
Required primary guest name.
Primary guest email
Required primary guest email for claim and registration workflows.
Primary guest phone
Optional primary guest phone.
Guests
Optional positive integer.
Total price
Optional reservation total as a number.
Currency
Optional ISO currency code. Defaults to CZK when Total price is present.
Status: deleted
Optional deletion marker. Keep the same external ID and set Status: deleted, Status: cancelled, Deleted: true, Cancelled: true, or Canceled: true to soft-cancel the reservation in Superhostem.
Plain text DESCRIPTION example
External ID: booking-123
Primary guest name: Jane Doe
Primary guest email: jane@example.com
Primary guest phone: +420777111222
Guests: 2
Total price: 12500
Currency: CZK
Full iCalendar example
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Your System//Superhostem ICS 1.0//EN
X-SUPERHOSTEM-FORMAT:1
BEGIN:VEVENT
UID:booking-123@example.com
X-SUPERHOSTEM-EXTERNAL-ID:booking-123
DTSTART;VALUE=DATE:20260901
DTEND;VALUE=DATE:20260905
SUMMARY:Jane Doe
DESCRIPTION:External ID: booking-123\nPrimary guest name: Jane Doe\nPrimary guest email: jane@example.com\nPrimary guest phone: +420777111222\nGuests: 2\nTotal price: 12500\nCurrency: CZK
END:VEVENT
END:VCALENDAR
Deleted reservation DESCRIPTION example
External ID: booking-123
Status: deleted