Hostfully API

Name: Hostfully API
Brand: Hostfully API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentE CommerceOrder ManagementapiKey,oauth231 EndpointsREST

For Agents

Manage vacation rental properties, leads/bookings, guest messages, photos, and pricing inside a Hostfully account.

Install Jentic One Beta

Connect the Hostfully API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Hostfully API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Hostfully API.

Create, update, and delete vacation rental property listings

Capture and convert leads into bookings, holds, or declines

Send and resend messages to guests on a booking thread

Upload, replace, and reorder property photos with metadata

GET STARTED

Start building with Hostfully API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Hostfully API for, with concrete tasks.

★ Inquiry-to-Booking Conversion Agent

Run an agent that turns inbound inquiries into Hostfully leads and walks them toward booking. The agent calls POST /api/v3/leads to capture each inquiry, then POST /api/v3/leads/{uid}/mark-as-booked when the guest commits, or POST /api/v3/leads/{uid}/decline when criteria do not match. Reduces the manual back-and-forth on every inquiry.

Create a lead for property uid xyz with the inquiry details, then mark it booked via POST /api/v3/leads/{uid}/mark-as-booked once payment confirms.

Guest Messaging Concierge

Power a guest concierge that sends pre-arrival instructions, mid-stay check-ins, and post-stay reviews. The agent calls POST /api/v3.2/messages with a templated payload and tracks delivery via GET /api/v3.2/messages/{messageUid}. Resend failed messages with the resend endpoint without duplicating the thread.

Send a check-in instructions message to the booking guest 48 hours before arrival via POST /api/v3.2/messages.

Listing Refresh and Photo Management

Keep a Hostfully portfolio fresh by uploading new photos and updating listing copy through the API. The agent calls POST /api/v3/properties/{uid}/photos to add seasonal hero shots, PATCH /api/v3/photos/{uid} to update captions, and DELETE for retired imagery. Useful for chains running seasonal refreshes across many units.

Upload a new hero photo to property uid abc and PATCH the photo metadata to set it as the cover image.

Dynamic Pricing Sync

Sync nightly rates and minimum stays from a pricing engine into Hostfully. The agent retrieves recommended pricing externally, then writes updates through the Pricing endpoints so they propagate to connected channels. Stops manual rate sheet uploads.

Read recommended rates from the pricing engine and write nightly rates into Hostfully for property uid xyz for the next 30 days.

AI Property Operations Agent via Jentic

Expose Hostfully's 31 endpoints to an AI agent through Jentic so it can manage properties, leads, messages, photos, and pricing without you maintaining a custom client. Jentic stores the API key in the MAXsystem vault and surfaces each operation by intent search.

Search Jentic for 'mark Hostfully lead as booked', load the schema, and execute against the lead uid for a confirmed reservation.

Key Endpoints

31 endpoints — jentic publishes the only available openapi specification for hostfully api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/api/v3/properties

List vacation rental properties

POST

/api/v3/leads

Create a lead for an inquiry

POST

/api/v3/leads/{uid}/mark-as-booked

Convert a lead to a booking

POST

/api/v3/leads/{uid}/cancel

Cancel a booking

POST

/api/v3.2/messages

Send a guest message

POST

/api/v3/properties/{uid}/photos

Upload a property photo

GET

/api/v3/properties

List vacation rental properties

POST

/api/v3/leads

Create a lead for an inquiry

POST

/api/v3/leads/{uid}/mark-as-booked

Convert a lead to a booking

POST

/api/v3/leads/{uid}/cancel

Cancel a booking

POST

/api/v3.2/messages

Send a guest message

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Hostfully API keys and OAuth tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped execution rights — raw credentials never enter the prompt.

Intent-based discovery

Across 31 endpoints (leads, properties, messages, photos, pricing), agents use Jentic's intent search to find the right operation by natural language rather than reading docs.

Time to first call

Direct integration: 1-2 days for auth, lead state transitions, and photo upload handling. Through Jentic: under an hour for the first call.

FAQs

Specific to using Hostfully API through Jentic.

Why is there no official OpenAPI spec for Hostfully API?

Hostfully does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Hostfully API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Hostfully API use?

Two options: an API key passed in a request header, or OAuth 2.0 for partner integrations. Jentic stores either credential in the MAXsystem vault and injects it at execution time, so the raw secret never enters the agent's context.

Can I convert a lead to a booking with the Hostfully API?

Yes. POST /api/v3/leads/{uid}/mark-as-booked transitions a lead to a confirmed booking. Related transitions include cancel, close, hold, and decline — each is a dedicated POST endpoint that records the action against the lead's audit trail.

What are the rate limits for the Hostfully API?

Hostfully applies tenant-level rate limits that scale with plan tier. Honor 429 responses, paginate list calls, and avoid hot-loop polling on /api/v3.2/messages — webhooks are preferred for message delivery state.

How do I send a guest message with the Hostfully API through Jentic?

Run pip install jentic, search for 'send guest message in Hostfully', load the POST /api/v3.2/messages schema, and execute with the booking and message body. Jentic handles auth automatically.

Can I update property photos with the Hostfully API?

Yes. POST /api/v3/properties/{uid}/photos uploads a new photo, PUT /api/v3/photos/{uid} replaces the file, PATCH /api/v3/photos/{uid} updates metadata, and DELETE removes a photo from the listing.

Hostfully API

Connect the Hostfully API to your agent

Capabilities

Start building with Hostfully API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs