# Hospitable

> Run your Hospitable short-term rentals from workflows: find and add reservations, open or block calendar days and set prices, message guests and reply to inquiries, respond to reviews, read payouts and manage cleaning tasks. Start a workflow when a reservation is booked or changes, a guest writes, an inquiry or review comes in, or a payout is sent.

App · 24 actions. Web page: https://docs.lodol.com/docs/integrations/hospitable

## Actions

### Cancel reservation

Cancel a manual reservation, opening its nights again. Reservations from Airbnb, Vrbo or Booking.com are cancelled on the channel.

**Inputs**

- Reservation ID (`reservation_id`, text, required): The reservation's ID, from 'Find reservations', a trigger or an earlier step.
- Cancelled by (`cancelled_by`, text): Who called it off. One of: `host` (The host), `guest` (The guest).

**Outputs**

- `reservation` (object): The reservation

**Example output**

```json
{
  "reservation": {
    "arrival_date": "2026-12-20T15:00:00+01:00",
    "booking_date": "2026-10-01T10:15:00Z",
    "conversation_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
    "departure_date": "2026-12-23T11:00:00+01:00",
    "guest": {
      "email": "sam@example.com",
      "first_name": "Sam",
      "last_name": "Guest",
      "phone_numbers": [
        "+15555550123"
      ]
    },
    "guests": {
      "adult_count": 2,
      "child_count": 0,
      "infant_count": 0,
      "pet_count": 0,
      "total": 2
    },
    "id": "becd1474-ccd1-40bf-9ce8-04456bfa338d",
    "nights": 3,
    "notes": "",
    "platform": "airbnb",
    "platform_id": "HM5XA4ZQ2B",
    "properties": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Relaxing Villa near the sea",
        "public_name": "Relaxing Villa near the sea"
      }
    ],
    "status": "cancelled"
  }
}
```

### Create reservation

Add a manual reservation, such as a direct or phone booking. Hospitable blocks its nights on every channel the property is on. The nights must be free of other bookings.

**Inputs**

- Property (`property_id`, text, required): The property. Pick one, or give its ID from an earlier step.
- Check-in (`check_in`, date, required): The day the stay starts.
- Check-out (`check_out`, date, required): The day the stay ends.
- Adults (`adults`, number, required): How many adults. From 1 to 100.
- Children (`children`, number): How many children (2 to 12). From 0 to 100.
- Infants (`infants`, number): How many infants (under 2). From 0 to 100.
- Pets (`pets`, number): How many pets. From 0 to 100.
- Guest first name (`first_name`, text, required): The guest's first name.
- Guest last name (`last_name`, text, required): The guest's last name.
- Guest email (`email`, text, required): The guest's email address.
- Guest phone (`phone`, text): The guest's phone number, with the country code.
- Guest language (`language`, text): The language to write to the guest in. Defaults to English. One of: `en` (English), `es` (Spanish), `fr` (French), `de` (German), `it` (Italian), `pt` (Portuguese), `nl` (Dutch), `ca` (Catalan), `da` (Danish), `sv` (Swedish), and 19 more.
- Accommodation price (`accommodation`, text, required): What the nights cost in all, before fees, such as 450 or 450.50.
- Cleaning fee (`cleaning_fee`, text): The cleaning fee, such as 60.
- Currency (`currency`, text): The three-letter currency code, such as USD. Leave blank for the property's currency.
- Reservation code (`reservation_code`, text): Your own code for it, up to 50 characters. Leave blank and Hospitable makes one.
- Note (`notes`, text): An internal note, for you and your team.

**Outputs**

- `reservation` (object): The reservation

**Example output**

```json
{
  "reservation": {
    "arrival_date": "2026-12-20T15:00:00+01:00",
    "booking_date": "2026-10-01T10:15:00Z",
    "conversation_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
    "departure_date": "2026-12-23T11:00:00+01:00",
    "guest": {
      "email": "sam@example.com",
      "first_name": "Sam",
      "last_name": "Guest",
      "phone_numbers": [
        "+15555550123"
      ]
    },
    "guests": {
      "adult_count": 2,
      "child_count": 0,
      "infant_count": 0,
      "pet_count": 0,
      "total": 2
    },
    "id": "becd1474-ccd1-40bf-9ce8-04456bfa338d",
    "nights": 3,
    "notes": "",
    "platform": "manual",
    "platform_id": "M1234567",
    "properties": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Relaxing Villa near the sea",
        "public_name": "Relaxing Villa near the sea"
      }
    ],
    "status": "accepted"
  }
}
```

### Create task

Add a task, such as a cleaning or a repair, to a property, and give it to one of your team.

**Inputs**

- Property (`property_id`, text, required): The property. Pick one, or give its ID from an earlier step.
- Type (`task_type`, text, required): What kind of task it is.
- Starts (`start_at`, date and time, required): When the task starts.
- Ends (`end_at`, date and time, required): When the task ends, after it starts.
- Teammate (`teammate_id`, text): Who does it. Pick one of your team, or give their ID.
- Reservation ID (`reservation_id`, text): The reservation it is for. Leave blank and Hospitable links it by its dates.
- Note (`note`, text): Instructions for whoever does it, up to 1000 characters.
- Send a reminder (`send_task_reminder`, true/false): Remind the teammate before the task starts.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "end_date": "2026-12-23T14:00:00+01:00",
    "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
    "name": "Cleaning",
    "note": "Fresh towels for 2.",
    "progress_status": "not_started",
    "property": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Relaxing Villa near the sea"
    },
    "start_date": "2026-12-23T11:00:00+01:00",
    "task_assignment": {
      "status": "unassigned"
    },
    "task_type": 1
  }
}
```

### Delete task

Delete a task for good.

**Inputs**

- Task ID (`task_id`, text, required): The task's ID, from 'Find tasks', 'Create task' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `task_id` (text): The task deleted

**Example output**

```json
{
  "deleted": true,
  "task_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f"
}
```

### Find available properties

Check every property for a stay: whether each is free for those nights and guests, and what the stay would cost. Up to 90 nights, up to 3 years ahead.

**Inputs**

- Check-in (`start_date`, date, required): The day the stay starts.
- Check-out (`end_date`, date, required): The day the stay ends.
- Adults (`adults`, number, required): How many adults. From 1 to 100.
- Children (`children`, number): How many children (2 to 12). From 0 to 100.
- Infants (`infants`, number): How many infants (under 2). From 0 to 100.
- Pets (`pets`, number): How many pets. From 0 to 100.

**Outputs**

- `available_count` (number): How many are free for the stay
- `count` (number): How many properties were checked
- `results` (list): Each property, with its availability and price

**Example output**

```json
{
  "available_count": 1,
  "count": 1,
  "results": [
    {
      "availability": {
        "available": true
      },
      "pricing": {
        "total": {
          "amount": 49500,
          "formatted": "\u20ac495.00"
        },
        "total_without_taxes": {
          "amount": 45000,
          "formatted": "\u20ac450.00"
        }
      },
      "property": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Relaxing Villa near the sea",
        "public_name": "Relaxing Villa near the sea"
      }
    }
  ]
}
```

### Find reservations

Find reservations by property, dates, status or channel, with the guest and property. With no dates, Hospitable lists stays checking in over the next two weeks. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Property (`property_id`, text): Only this property. Leave blank for every property in the account.
- From (`start_date`, date): Only from this day.
- Until (`end_date`, date): Only up to this day.
- Dates are (`date_query`, text): Which date From and Until look at. One of: `checkin` (Check-in date (default)), `checkout` (Check-out date), `booked_at` (Booking date).
- Status (`statuses`, list): Only reservations in these statuses. One or more of: `accepted`, `request`, `cancelled`, `not_accepted` (Not accepted), `checkpoint`.
- Channel (`platforms`, list): Only reservations from these channels. One or more of: `airbnb`, `homeaway` (Vrbo), `booking` (Booking.com), `agoda`, `direct`, `manual`, `ical`.
- Reservation code (`reservation_code`, text): Only the reservation with this code, such as HMABC123.
- Booked after (`booked_after`, date and time): Only reservations booked after this time.
- Order (`sort`, text): How to order them. One of: `start_date_asc` (Check-in, earliest first), `start_date_desc` (Check-in, latest first), `booked_at_desc` (Newest booking first), `booked_at_asc` (Oldest booking first).
- Page (`page`, number): Which page of results, starting at 1. Each step gets one page. At least 1.
- Per page (`per_page`, number): How many to get, 1 to 100. Hospitable's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `last_page` (number): The number of the last page
- `next_page` (number): The next page's number, or 0 on the last page
- `page` (number): This page's number
- `reservations` (list): The reservations
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "last_page": 1,
  "next_page": 0,
  "page": 1,
  "reservations": [
    {
      "arrival_date": "2026-12-20T15:00:00+01:00",
      "booking_date": "2026-10-01T10:15:00Z",
      "conversation_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
      "departure_date": "2026-12-23T11:00:00+01:00",
      "guest": {
        "email": "sam@example.com",
        "first_name": "Sam",
        "last_name": "Guest",
        "phone_numbers": [
          "+15555550123"
        ]
      },
      "guests": {
        "adult_count": 2,
        "child_count": 0,
        "infant_count": 0,
        "pet_count": 0,
        "total": 2
      },
      "id": "becd1474-ccd1-40bf-9ce8-04456bfa338d",
      "nights": 3,
      "notes": "",
      "platform": "airbnb",
      "platform_id": "HM5XA4ZQ2B",
      "properties": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "Relaxing Villa near the sea",
          "public_name": "Relaxing Villa near the sea"
        }
      ],
      "status": "accepted"
    }
  ],
  "total": 1
}
```

### Find tasks

Find tasks, such as cleanings, by property, dates, type, status, reservation or teammate. With no dates, Hospitable lists the next two weeks'. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Property (`property_id`, text): Only this property. Leave blank for every property in the account.
- From (`start_date`, date): Only from this day.
- Until (`end_date`, date): Only up to this day.
- Type (`task_type`, text): Only tasks of this type.
- Status (`statuses`, list): Only tasks in these statuses. One or more of: `not_started` (Not started), `on_the_way` (On the way), `arrived`, `in_progress` (In progress), `completed`, `pending` (Waiting for the teammate to accept), `accepted` (Accepted by the teammate), `rejected` (Turned down by the teammate), `unassigned` (Not assigned), `cancelled`.
- Reservation ID (`reservation_id`, text): Only tasks for this reservation.
- Teammate (`teammate_id`, text): Only tasks given to this teammate.
- Page (`page`, number): Which page of results, starting at 1. Each step gets one page. At least 1.
- Per page (`per_page`, number): How many to get, 1 to 100. Hospitable's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `last_page` (number): The number of the last page
- `next_page` (number): The next page's number, or 0 on the last page
- `page` (number): This page's number
- `tasks` (list): The tasks
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "last_page": 1,
  "next_page": 0,
  "page": 1,
  "tasks": [
    {
      "end_date": "2026-12-23T14:00:00+01:00",
      "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
      "name": "Cleaning",
      "note": "Fresh towels for 2.",
      "progress_status": "not_started",
      "property": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Relaxing Villa near the sea"
      },
      "start_date": "2026-12-23T11:00:00+01:00",
      "task_assignment": {
        "status": "unassigned"
      },
      "task_type": 1
    }
  ],
  "total": 1
}
```

### Get account

Get the Hospitable account the connection uses: its owner's name and email and its billing details.

**Inputs**: None.

**Outputs**

- `user` (object): The account

**Example output**

```json
{
  "user": {
    "business": false,
    "city": "Miami",
    "company": "",
    "country": "US",
    "email": "host@example.com",
    "id": "f0d9c1a2-5b3e-4c7d-8e9f-0a1b2c3d4e5f",
    "name": "Jo Bloggs"
  }
}
```

### Get calendar

Get a property's calendar day by day: whether each day can be booked, its price, minimum stay and check-in and check-out rules.

**Inputs**

- Property (`property_id`, text, required): The property. Pick one, or give its ID from an earlier step.
- From (`start_date`, date): The first day. Leave blank for today.
- Until (`end_date`, date): The last day. Leave blank for Hospitable's default range.

**Outputs**

- `count` (number): How many days
- `days` (list): The days
- `end_date` (text): The last day (YYYY-MM-DD)
- `start_date` (text): The first day (YYYY-MM-DD)

**Example output**

```json
{
  "count": 1,
  "days": [
    {
      "closed_for_checkin": false,
      "closed_for_checkout": false,
      "date": "2026-12-20",
      "day": "SUNDAY",
      "min_stay": 2,
      "note": "",
      "price": {
        "amount": 15000,
        "currency": "EUR",
        "formatted": "\u20ac150.00"
      },
      "status": {
        "available": true,
        "reason": "AVAILABLE"
      }
    }
  ],
  "end_date": "2026-12-20",
  "start_date": "2026-12-20"
}
```

### Get inquiry

Get an inquiry with the guest, the property, the dates they asked about and their messages.

**Inputs**

- Inquiry ID (`inquiry_id`, text, required): The inquiry's ID, from 'List inquiries' or the 'New inquiry' trigger.

**Outputs**

- `inquiry` (object): The inquiry

**Example output**

```json
{
  "inquiry": {
    "arrival_date": "2026-12-20",
    "departure_date": "2026-12-23",
    "guest": {
      "first_name": "Sam",
      "last_name": "Guest"
    },
    "guests": {
      "adult_count": 2,
      "child_count": 0,
      "infant_count": 0,
      "pet_count": 0,
      "total": 2
    },
    "id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
    "inquiry_date": "2026-10-02T08:30:00Z",
    "messages": [
      {
        "body": "Hi! What time can we check in?",
        "conversation_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
        "created_at": "2026-10-02T08:30:00Z",
        "platform": "airbnb",
        "reservation_id": "",
        "sender": {
          "first_name": "Sam",
          "full_name": "Sam Guest"
        },
        "sender_type": "guest",
        "source": "platform"
      }
    ],
    "platform": "airbnb",
    "properties": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Relaxing Villa near the sea",
      "public_name": "Relaxing Villa near the sea"
    }
  }
}
```

### Get property

Get one property's address, capacity, check-in and check-out times, currency and the channels it is listed on.

**Inputs**

- Property (`property_id`, text, required): The property. Pick one, or give its ID from an earlier step.

**Outputs**

- `property` (object): The property

**Example output**

```json
{
  "property": {
    "address": {
      "city": "Berlin",
      "country": "DE",
      "display": "32 Senefelderplatz, Berlin, 10405, Germany",
      "postcode": "10405",
      "state": "Berlin",
      "street": "Senefelderplatz"
    },
    "calendar_restricted": false,
    "capacity": {
      "bathrooms": 2,
      "bedrooms": 3,
      "max": 6
    },
    "currency": "EUR",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "listed": true,
    "listings": [
      {
        "platform": "airbnb",
        "platform_id": "24488"
      }
    ],
    "name": "Relaxing Villa near the sea",
    "picture": "https://assets.hospitable.com/property_images/villa.jpg",
    "property_type": "villa",
    "public_name": "Relaxing Villa near the sea",
    "room_type": "entire_home",
    "tags": [
      "Berlin"
    ],
    "timezone": "+0200"
  }
}
```

### Get reservation

Get a reservation's guest, property, dates, status, guests and what it pays, by its ID or its reservation code.

**Inputs**

- Reservation (`reservation_id`, text, required): The reservation's ID, or its reservation code such as HMABC123.

**Outputs**

- `reservation` (object): The reservation

**Example output**

```json
{
  "reservation": {
    "arrival_date": "2026-12-20T15:00:00+01:00",
    "booking_date": "2026-10-01T10:15:00Z",
    "conversation_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
    "departure_date": "2026-12-23T11:00:00+01:00",
    "guest": {
      "email": "sam@example.com",
      "first_name": "Sam",
      "last_name": "Guest",
      "phone_numbers": [
        "+15555550123"
      ]
    },
    "guests": {
      "adult_count": 2,
      "child_count": 0,
      "infant_count": 0,
      "pet_count": 0,
      "total": 2
    },
    "id": "becd1474-ccd1-40bf-9ce8-04456bfa338d",
    "nights": 3,
    "notes": "",
    "platform": "airbnb",
    "platform_id": "HM5XA4ZQ2B",
    "properties": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Relaxing Villa near the sea",
        "public_name": "Relaxing Villa near the sea"
      }
    ],
    "status": "accepted"
  }
}
```

### List inquiries

List guest inquiries: conversations about a stay that hasn't been booked yet. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Property (`property_id`, text): Only this property. Leave blank for every property in the account.
- Page (`page`, number): Which page of results, starting at 1. Each step gets one page. At least 1.
- Per page (`per_page`, number): How many to get, 1 to 100. Hospitable's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `inquiries` (list): The inquiries
- `last_page` (number): The number of the last page
- `next_page` (number): The next page's number, or 0 on the last page
- `page` (number): This page's number
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "inquiries": [
    {
      "arrival_date": "2026-12-20",
      "departure_date": "2026-12-23",
      "guest": {
        "first_name": "Sam",
        "last_name": "Guest"
      },
      "guests": {
        "adult_count": 2,
        "child_count": 0,
        "infant_count": 0,
        "pet_count": 0,
        "total": 2
      },
      "id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
      "inquiry_date": "2026-10-02T08:30:00Z",
      "platform": "airbnb",
      "properties": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Relaxing Villa near the sea",
        "public_name": "Relaxing Villa near the sea"
      }
    }
  ],
  "last_page": 1,
  "next_page": 0,
  "page": 1,
  "total": 1
}
```

### List messages

List the messages between the host and the guest of a reservation. Hospitable allows this twice a minute for each reservation.

**Inputs**

- Reservation ID (`reservation_id`, text, required): The reservation's ID, from 'Find reservations', a trigger or an earlier step.

**Outputs**

- `count` (number): How many
- `messages` (list): The messages

**Example output**

```json
{
  "count": 1,
  "messages": [
    {
      "body": "Hi! What time can we check in?",
      "conversation_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
      "created_at": "2026-10-02T08:30:00Z",
      "platform": "airbnb",
      "reservation_id": "becd1474-ccd1-40bf-9ce8-04456bfa338d",
      "sender": {
        "first_name": "Sam",
        "full_name": "Sam Guest"
      },
      "sender_type": "guest",
      "source": "platform"
    }
  ]
}
```

### List payouts

List the payouts the booking channels sent to your bank. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Page (`page`, number): Which page of results, starting at 1. Each step gets one page. At least 1.
- Per page (`per_page`, number): How many to get, 1 to 100. Hospitable's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `last_page` (number): The number of the last page
- `next_page` (number): The next page's number, or 0 on the last page
- `page` (number): This page's number
- `payouts` (list): The payouts
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "last_page": 1,
  "next_page": 0,
  "page": 1,
  "payouts": [
    {
      "amount": {
        "amount": 45000,
        "currency": "EUR",
        "formatted": "\u20ac450.00"
      },
      "bank_account": "Checking 1234",
      "date": "2026-12-21",
      "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
      "platform": "airbnb",
      "reference": "G-123ABC"
    }
  ],
  "total": 1
}
```

### List properties

List the properties in the account with their addresses, capacity and the channels they are listed on. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Page (`page`, number): Which page of results, starting at 1. Each step gets one page. At least 1.
- Per page (`per_page`, number): How many to get, 1 to 100. Hospitable's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `last_page` (number): The number of the last page
- `next_page` (number): The next page's number, or 0 on the last page
- `page` (number): This page's number
- `properties` (list): The properties
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "last_page": 1,
  "next_page": 0,
  "page": 1,
  "properties": [
    {
      "address": {
        "city": "Berlin",
        "country": "DE",
        "display": "32 Senefelderplatz, Berlin, 10405, Germany",
        "postcode": "10405",
        "state": "Berlin",
        "street": "Senefelderplatz"
      },
      "calendar_restricted": false,
      "capacity": {
        "bathrooms": 2,
        "bedrooms": 3,
        "max": 6
      },
      "currency": "EUR",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "listed": true,
      "listings": [
        {
          "platform": "airbnb",
          "platform_id": "24488"
        }
      ],
      "name": "Relaxing Villa near the sea",
      "picture": "https://assets.hospitable.com/property_images/villa.jpg",
      "property_type": "villa",
      "public_name": "Relaxing Villa near the sea",
      "room_type": "entire_home",
      "tags": [
        "Berlin"
      ],
      "timezone": "+0200"
    }
  ],
  "total": 1
}
```

### List reviews

List the reviews guests left for a property, with their stars, what they wrote, private feedback and any response. Gets one page of up to 50.

**Inputs**

- Property (`property_id`, text, required): The property. Pick one, or give its ID from an earlier step.
- Page (`page`, number): Which page of results, starting at 1. Each step gets one page. At least 1.
- Per page (`per_page`, number): How many to get, 1 to 50. Hospitable's default is 10. From 1 to 50.

**Outputs**

- `count` (number): How many are on this page
- `last_page` (number): The number of the last page
- `next_page` (number): The next page's number, or 0 on the last page
- `page` (number): This page's number
- `reviews` (list): The reviews
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "last_page": 1,
  "next_page": 0,
  "page": 1,
  "reviews": [
    {
      "can_respond": true,
      "guest": {
        "first_name": "Sam",
        "last_name": "Guest"
      },
      "id": "2f8c6a4e-1b3d-4e5f-9a7b-8c6d5e4f3a2b",
      "platform": "airbnb",
      "private": {
        "feedback": ""
      },
      "public": {
        "rating": 5,
        "response": "",
        "review": "Lovely stay, spotless and close to the beach."
      },
      "reservation": {
        "code": "HM5XA4ZQ2B",
        "id": "becd1474-ccd1-40bf-9ce8-04456bfa338d"
      },
      "reviewed_at": "2026-10-25T09:00:00Z"
    }
  ],
  "total": 1
}
```

### List transactions

List the account's transactions, such as what each reservation paid out, newest first as Hospitable lists them. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Page (`page`, number): Which page of results, starting at 1. Each step gets one page. At least 1.
- Per page (`per_page`, number): How many to get, 1 to 100. Hospitable's default is 10. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `last_page` (number): The number of the last page
- `next_page` (number): The next page's number, or 0 on the last page
- `page` (number): This page's number
- `total` (number): How many there are in all
- `transactions` (list): The transactions

**Example output**

```json
{
  "count": 1,
  "last_page": 1,
  "next_page": 0,
  "page": 1,
  "total": 1,
  "transactions": [
    {
      "amount": {
        "amount": 45000,
        "currency": "EUR",
        "formatted": "\u20ac450.00"
      },
      "date": "2026-12-21",
      "details": "Dec 20 to 23, 2026 HM5XA4ZQ2B",
      "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "platform": "airbnb",
      "reference": "HM5XA4ZQ2B",
      "type": "Reservation"
    }
  ]
}
```

### Reply to inquiry

Reply to a guest's inquiry through the channel they wrote on. Hospitable allows 2 messages a minute to one guest.

**Inputs**

- Inquiry ID (`inquiry_id`, text, required): The inquiry's ID, from 'List inquiries' or the 'New inquiry' trigger.
- Message (`body`, text, required): What to say. Plain text; new lines are kept.
- Send as co-host (`sender_id`, text): On Airbnb only: the co-host user ID to send as, from the property's listings. Leave blank to send as the listing's owner.

**Outputs**

- `inquiry_id` (text): The inquiry replied to
- `sent` (true/false): Always true once Hospitable has taken the message
- `sent_reference_id` (text): Hospitable's reference for the message

**Example output**

```json
{
  "inquiry_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
  "sent": true,
  "sent_reference_id": "e5d4c3b2-a1f0-4e9d-8c7b-6a5f4e3d2c1b"
}
```

### Respond to review

Publish your public response to a guest's review on Airbnb or Booking.com. Each review takes one response, within the channel's time limit, and it can't be taken back.

**Inputs**

- Review ID (`review_id`, text, required): The review's ID, from 'List reviews' or the 'New review' trigger.
- Response (`response`, text, required): Your response, as everyone will see it.

**Outputs**

- `review` (object): The review

**Example output**

```json
{
  "review": {
    "can_respond": false,
    "guest": {
      "first_name": "Sam",
      "last_name": "Guest"
    },
    "id": "2f8c6a4e-1b3d-4e5f-9a7b-8c6d5e4f3a2b",
    "platform": "airbnb",
    "private": {
      "feedback": ""
    },
    "public": {
      "rating": 5,
      "response": "Thank you, Sam! Come back soon.",
      "review": "Lovely stay, spotless and close to the beach."
    },
    "reservation": {
      "code": "HM5XA4ZQ2B",
      "id": "becd1474-ccd1-40bf-9ce8-04456bfa338d"
    },
    "reviewed_at": "2026-10-25T09:00:00Z"
  }
}
```

### Send message

Message a reservation's guest through the channel they booked on. Hospitable allows 2 messages a minute to one guest, and 50 every 5 minutes.

**Inputs**

- Reservation ID (`reservation_id`, text, required): The reservation's ID, from 'Find reservations', a trigger or an earlier step.
- Message (`body`, text, required): What to say. Plain text; new lines are kept.
- Images (`images`, list): Up to 3 links to images to attach, each at most 5 MB.
- Send as co-host (`sender_id`, text): On Airbnb only: the co-host user ID to send as, from the property's listings. Leave blank to send as the listing's owner.

**Outputs**

- `reservation_id` (text): The reservation messaged
- `sent` (true/false): Always true once Hospitable has taken the message
- `sent_reference_id` (text): Hospitable's reference for the message

**Example output**

```json
{
  "reservation_id": "becd1474-ccd1-40bf-9ce8-04456bfa338d",
  "sent": true,
  "sent_reference_id": "e5d4c3b2-a1f0-4e9d-8c7b-6a5f4e3d2c1b"
}
```

### Update calendar

Open or block a property's days, and set their nightly price, minimum stay, check-in and check-out rules or note. Hospitable sends the change to every channel the property is on. Fields left blank keep what the days have.

**Inputs**

- Property (`property_id`, text, required): The property. Pick one, or give its ID from an earlier step.
- From (`start_date`, date, required): The first day to change.
- Until (`end_date`, date): The last day to change, up to a year after the first. Leave blank to change only the first day.
- Availability (`availability`, text): Open the days for booking, or block them. One of: `available` (Open for booking), `blocked`.
- Nightly price (`price`, text): The price a night, in the property's currency, such as 150 or 150.50.
- Minimum stay (`min_stay`, number): The fewest nights a stay starting on these days may have. From 1 to 365.
- Check-in (`check_in`, text): Whether a stay may start on these days. One of: `allowed`, `closed` (Not allowed).
- Check-out (`check_out`, text): Whether a stay may end on these days. One of: `allowed`, `closed` (Not allowed).
- Note (`note`, text): A note on the days, for you and your team, up to 512 characters.

**Outputs**

- `currency` (text): The property's currency, if a price was set
- `days_changed` (number): How many days were changed
- `end_date` (text): The last day changed
- `price_minor_units` (number): The nightly price sent, in the currency's smallest unit (0 if none)
- `property_id` (text): The property changed
- `start_date` (text): The first day changed
- `status` (text): Hospitable's answer, accepted

**Example output**

```json
{
  "currency": "EUR",
  "days_changed": 3,
  "end_date": "2026-12-22",
  "price_minor_units": 15000,
  "property_id": "550e8400-e29b-41d4-a716-446655440000",
  "start_date": "2026-12-20",
  "status": "accepted"
}
```

### Update reservation

Change a reservation's internal note, or its check-in or check-out time, on any channel. Fields left blank keep what they have.

**Inputs**

- Reservation ID (`reservation_id`, text, required): The reservation's ID, from 'Find reservations', a trigger or an earlier step.
- Note (`notes`, text): A new internal note, for you and your team.
- Check-in time (`checkin_time`, time): The guest's new check-in time.
- Check-out time (`checkout_time`, time): The guest's new check-out time.

**Outputs**

- `reservation` (object): The reservation

**Example output**

```json
{
  "reservation": {
    "arrival_date": "2026-12-20T15:00:00+01:00",
    "booking_date": "2026-10-01T10:15:00Z",
    "conversation_id": "0a39f7af-b054-4788-8768-d15bb1ebc62d",
    "departure_date": "2026-12-23T11:00:00+01:00",
    "guest": {
      "email": "sam@example.com",
      "first_name": "Sam",
      "last_name": "Guest",
      "phone_numbers": [
        "+15555550123"
      ]
    },
    "guests": {
      "adult_count": 2,
      "child_count": 0,
      "infant_count": 0,
      "pet_count": 0,
      "total": 2
    },
    "id": "becd1474-ccd1-40bf-9ce8-04456bfa338d",
    "nights": 3,
    "notes": "Late arrival",
    "platform": "airbnb",
    "platform_id": "HM5XA4ZQ2B",
    "properties": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Relaxing Villa near the sea",
        "public_name": "Relaxing Villa near the sea"
      }
    ],
    "status": "accepted"
  }
}
```

### Update task

Change a task's times, teammate or note. Fields left blank keep what they have.

**Inputs**

- Task ID (`task_id`, text, required): The task's ID, from 'Find tasks', 'Create task' or an earlier step.
- Starts (`start_at`, date and time): When it starts now.
- Ends (`end_at`, date and time): When it ends now.
- Teammate (`teammate_id`, text): Who does it. Pick one of your team, or give their ID.
- Note (`note`, text): A new note, up to 1000 characters.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "end_date": "2026-12-23T14:00:00+01:00",
    "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
    "name": "Cleaning",
    "note": "Fresh towels for 4.",
    "progress_status": "not_started",
    "property": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Relaxing Villa near the sea"
    },
    "start_date": "2026-12-23T11:00:00+01:00",
    "task_assignment": {
      "status": "unassigned"
    },
    "task_type": 1
  }
}
```
