API Reference

Create Reservation

post
https://app.hosttools.com/api/createReservation

Creates a new internal reservation for the specified listing. This endpoint allows
partners to programmatically create reservations on behalf of hosts.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Reservation details

string
required

ID of the listing to create reservation for

string
required

Check-in date in YYYY-MM-DD format

string
required

Check-out date in YYYY-MM-DD format

string
required

Custom confirmation code for the reservation

string
required

Guest's first name

string
required

Guest's last name

string
required

Guest's email address

string
required

Guest's phone number

guests
object
required

Number of guests

string
enum
Defaults to accepted

Initial status of the reservation

Allowed:
string

Internal notes for the reservation

number
0 to 23

Custom check-in time (0-23 hours)

number
0 to 23

Custom check-out time (0-23 hours)

string
enum

Guest's preferred language locale

number
required
≥ 0

Amount to be paid to host

number
required
≥ 0

Total amount paid by guest

Headers
string

Partner API key

string
required

User's authentication token

Responses

429

Too many requests

Updated 8 months ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 8 months ago