Superhostem.cz
Superhostem API v1

Public API documentation

Use an owner API token to trigger selected Superhostem automations from your own backend or internal tools.

Create accountManage API tokens
POST
/api/v1/calendars/sync
curl -X POST 'https://www.superhostem.cz/api/v1/calendars/sync' \
  -H 'x-api-key: sht_YOUR_TOKEN'
200

All calendars synced successfully.

207

Some calendars failed; inspect the results array.

401

Missing, expired, revoked, or invalid token.

How to get a personal API token

  1. 1Sign in to Superhostem with the owner account that should own the integration.
  2. 2Open Dashboard -> Settings -> Profile and find the API tokens section.
  3. 3Create a token, copy it immediately, and store it in your server or automation secret storage.
Open API token settings

Endpoint

Method
POST
Endpoint
/api/v1/calendars/sync
Request body
No JSON body is required.

Response

{
  "ok": true,
  "syncedCalendars": 3,
  "propertiesChecked": 2,
  "failed": 0,
  "durationMs": 1842,
  "results": [
    {
      "propertyId": "...",
      "propertyName": "Apartment Prague",
      "source": "airbnb",
      "ok": true,
      "result": {
        "status": "success",
        "reservationsFound": 4,
        "reservationsCreated": 1,
        "reservationsUpdated": 3,
        "reservationsCancelled": 0
      }
    }
  ]
}

JavaScript

const response = await fetch('https://www.superhostem.cz/api/v1/calendars/sync', {
  method: 'POST',
  headers: {
    'x-api-key': 'sht_YOUR_TOKEN',
  },
});

const result = await response.json();
console.log(result);