Update Reservation

post

https://app.hosttools.com/api/setReservation/{reservationID}

Updates reservation details including guest information, check-in/out times, and notes.

The updated values are stored with the reservation and will be used when:

Generating messages (message tags like {{Check-In Time}}, {{Guest First Name}}, etc.
will reflect the updated values)
Calculating lock code access periods (custom check-in/out times affect when codes are valid)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

reservationID

string

required

_id of reservation to update

Body Params

Reservation update fields

guideBookURL

string | null

URL of the guidebook

verificationURL

string | null

URL of the verification

verificationStatus

string | null

enum

Status of the verification

Allowed:

incidentURL

string | null

URL of the incident

firstName

string

Guest's first name (used in {{Guest First Name}} tag)

lastName

string

Guest's last name (used in {{Guest Last Name}} tag)

string

Guest's email address

phone

string

Guest's phone number (used in {{Guest Phone}} and {{Guest Lock Code}} tags)

accessCode

string | null

Custom smart lock code. Set to null or empty string to clear and use auto-generated code.

checkInTime

number

0 to 23

Custom check-in time in hours (0-23), used in {{Check-In Time}} tag and lock code scheduling

checkOutTime

number

0 to 23

Custom check-out time in hours (0-23), used in {{Check-Out Time}} tag and lock code scheduling

notes

string

Internal notes for the reservation (used in {{Notes}} tag)

Headers

apiKey

string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

authToken

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

429

Too many requests

200Reservation updated successfully

400Error