# Hostaway API

> Use when integrating with Hostaway property management system for Seascape Vacations.

- Skill: `uncfreak1255-code/hostaway-api` (Agent Skill)
- Install (CLI): `npx skillmds@latest add uncfreak1255-code/hostaway-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uncfreak1255-code/hostaway-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: uncfreak1255-code (https://skillmd.com/u/uncfreak1255-code)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/uncfreak1255-code/hostaway-api

---


# Hostaway API Integration Skill

## Overview
Hostaway is the PMS for Seascape Vacations. All property data, reservations, guest messaging, and calendar management flows through Hostaway.

## Authentication
- OAuth2 with client_id and client_secret
- Token endpoint: POST https://api.hostaway.com/v1/accessTokens  
- Include Bearer token in Authorization header

## Key Endpoints
- GET /v1/listings - All managed properties
- GET /v1/reservations - Bookings with filters
- GET /v1/conversations - Guest message threads  
- POST /v1/conversations/{id}/messages - Send guest message
- GET /v1/calendars/{listingId} - Availability calendar
- GET /v1/listingFinancials - Revenue and financial data

## Integration Patterns
- Guest messaging system trained on 23,000+ historical messages
- Flask approval dashboards for message review
- Automated responses with human-in-the-loop approval
- Calendar sync for availability and pricing