hostex_skill

This skill helps you integrate with Hostex API for querying and managing properties, reservations, availability, and messages with safe, intent-level calls.

Python

2.6k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill hostex

_meta.json270 B
SKILL.md3.6 KB

Overview

This skill integrates with the Hostex OpenAPI v3.0 to query and manage vacation rental properties, room types, reservations, availability, listing calendars, guest messaging, reviews, and webhooks. It uses a Hostex Personal Access Token (Hostex-Access-Token) for authentication and defaults to read-only operations for safety. Write operations are possible but require explicit enabling and confirmation.

How this skill works

The skill issues intent-level API calls against Hostex endpoints using the HostexAccessToken security scheme and date parameters in YYYY-MM-DD interpreted in the property timezone. Read-only scripts and endpoints let you list properties, reservations, availability, and messages. Write operations (create/update/delete) are gated by an environment flag and require an explicit confirmation step and summarized changelog before applying.

When to use it

Sync property and room type metadata from Hostex into your system
Retrieve reservation lists or lookup a reservation by code or date range
Check calendar availability or bulk update listing prices
Send guest messages or process guest reviews via the Hostex messaging and reviews API
Create direct-booking reservations or update availabilities when required

Best practices

Use a read-only PAT for everyday queries; enable writes only when necessary.
Always provide dates in YYYY-MM-DD and assume the property's timezone for accurate results.
For any write operation: summarize the change, require explicit user confirmation, and prefer a dry-run before applying.
Respect pagination (offset + limit, max limit ~100) for listing endpoints to avoid missing data.
Never log or expose the Hostex access token; redact secrets and use environment variables.

Example use cases

Export all properties and room types to populate a channel manager or reporting DB
List reservations between two check-in dates to generate an arrival list or housekeeping schedule
Fetch availability for a property across a date range to power a booking widget
Update multiple listing price ranges in a single request for seasonal pricing changes
Send a pre-arrival message to a guest conversation or post a review response programmatically

FAQ

Set the Hostex PAT in an environment variable and send it as Hostex-Access-Token header; prefer a read-only PAT unless you need to perform writes.

Are write operations enabled by default?

No. Writes require HOSTEX_ALLOW_WRITES=true (or equivalent) and an explicit confirmation step before the skill performs changes.