Hostfully API · unofficial, by Cotlet

Create your own Hostfully API

Hostfully: API access is an add-on to the subscription; without it, no API key shows in Agency Settings (checked 20 Nov 2026). With Cotlet you can build your own. Do a job once with your AI agent in your Hostfully account, save it as an endpoint, and call it from n8n, Make, Zapier or your own code. Each endpoint runs in your own signed-in Hostfully session and returns only what your login can see.

Try it free now

Free 7-day trial, 2,000 credits, no card

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Hostfully. Hostfully is a trademark of its owner. If Hostfully's own integrations cover what you need, use them first.

curl
curl -X POST "https://cotlet.dev/api/v1/custom/weekend-check-ins" \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "2026-11-27", "to": "2026-11-29"}'
Node.js
const url = "https://cotlet.dev/api/v1/custom/weekend-check-ins";
const res = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COTLET_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ from: "2026-11-27", to: "2026-11-29" }),
});
const { data } = await res.json();
Python
import os
import requests

key = os.environ["COTLET_API_KEY"]
res = requests.post(
    "https://cotlet.dev/api/v1/custom/weekend-check-ins",
    headers={"Authorization": f"Bearer {key}"},
    json={"from": "2026-11-27", "to": "2026-11-29"},
)
data = res.json()["data"]
Response 200 OK · JSON
{
  "data": [
    {
      "property": "Ocean View",
      "guest": "Sam K.",
      "guests": 4,
      "arrival": "16:00"
    },
    {
      "property": "Harbor Loft",
      "guest": "Ria T.",
      "guests": 2,
      "arrival": "18:30"
    }
  ]
}

01 Build

How do you build a Hostfully endpoint with Cotlet?

  1. Sign in to Hostfully in your Cloud Browser.

    You type your password yourself. Cotlet keeps the signed-in session, encrypted, never the password.

  2. Do the job once with your agent.

    For example: "List the check-ins between these dates, with property, guest, guests and arrival time."

  3. Save it as an endpoint.

    Give it a name, choose its inputs, such as a date range or a property, and the fields it returns.

  4. Call it with your Cotlet API key.

    Each endpoint gets its own address, POST https://cotlet.dev/api/v1/custom/<name>. You send JSON in and get JSON back, from the same signed-in Hostfully session.

02 Endpoints

Example endpoints you could build for Hostfully

Cotlet ships no fixed list of Hostfully endpoints. You decide which endpoints you build and what each one returns.

  • POST /api/v1/custom/weekend-check-ins

    Check-ins for dates

    Property, guest, guests and arrival time

  • POST /api/v1/custom/open-inquiries

    Open inquiries

    Inquiries with no quote yet, with dates and property

  • POST /api/v1/custom/free-nights

    Free nights

    Properties with no booking in the dates you name

  • POST /api/v1/custom/balances-due

    Balances due

    Bookings that still owe money, with the amount

  • POST /api/v1/custom/add-booking-note writes

    Add a note to a booking

    A note on the booking you name

A call to an endpoint you built could look like this:

Request

curl -X POST "https://cotlet.dev/api/v1/custom/weekend-check-ins" \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "2026-11-27", "to": "2026-11-29"}'

The answer is JSON, with your fields under data:

Response · 200 OK

{
  "data": [
    {
      "property": "Ocean View",
      "guest": "Sam K.",
      "guests": 4,
      "arrival": "16:00"
    },
    {
      "property": "Harbor Loft",
      "guest": "Ria T.",
      "guests": 2,
      "arrival": "18:30"
    }
  ]
}

When you save an endpoint, Cotlet gives you its curl example and an OpenAPI description to paste into n8n, Make or your code.

03 Uses

What can you use your Hostfully endpoints for?

  • Thursday Cotlet endpoint Team chat

    A Thursday arrivals list.

    Weekend check-ins per property, sent to your cleaning team.

  • Monday endpoint Slack or email

    A balances check.

    Bookings that still owe money, sent to Slack or email each Monday.

  • Weekly endpoint Google Sheets

    Occupancy in a sheet.

    Booked and free nights per property pulled into Google Sheets.

  • Chat agent endpoint calendar

    Your own guest assistant.

    A chat agent that checks free nights before it answers a guest on your website.

04 Access

What can an endpoint see and change?

An endpoint works in your own Hostfully session, so it can read and change only what your Hostfully login can. An owner login sees the whole business. A team login sees what its permissions allow. You choose what each endpoint does when you build it.

An endpoint that changes something, such as adding a booking note, first runs as a dry run: Cotlet shows you each request it would send, and nothing is sent. You allow the writes once in the Cotlet console and set a daily cap. A call over the cap fails whole, never half done.

05 Official API

Does Hostfully have an official API?

Hostfully has an Open API as an add-on to the subscription, with the key in Agency Settings and a sandbox for testing on request (checked 20 Nov 2026). Its Zapier app has booking triggers and no actions. The full picture with sources: Does Hostfully have an API or MCP server?

Want ChatGPT or Claude to work in Hostfully instead of code? See the Hostfully MCP server.

06 Pricing

What does it cost?

per successful call
10 credits
when a call fails
0
in the smallest pack
≈ 500 calls
free trial, no card
7 days

A call to your endpoint costs 10 credits when it succeeds and nothing when it fails, with no browser minutes on top. Credits come in one-time packs from $29 for 5,000 credits, so a pack covers about 500 successful calls. The free trial gives you 2,000 credits for 7 days, no card.

Hostfully API with Cotlet: questions

Is this an official Hostfully API?

No. Cotlet is independent and not affiliated with Hostfully. The endpoints you build run in your own signed-in Hostfully account.

Do I need to code?

Not to build an endpoint: you do the job once with your agent and save it. To call it, you need a tool that sends HTTP requests, such as n8n, Make, Zapier or a script.

What happens when Hostfully changes its screens?

An endpoint works while Hostfully works the way it did when you built it. If Hostfully changes and a call fails, you get an email. After 3 failures in a row the endpoint turns off until you rebuild it with your agent or in the console. A failed call costs nothing.

How long can a call take?

Up to 90 seconds, and the answer can be up to 1 MB of JSON.

Build your first Hostfully endpoint

Sign in once, do the job with your agent and save it as an endpoint.

Try it free now

No card. Takes about 5 minutes.