Create & manage a new lead associated with an agency and a property.
In order to block availability, POST a BLOCK type of a lead.
In order to present in the UI an inquiry for the PM to work with use an INQUIRY type of a lead.
In order to propagate a confirmed booking that Hostfully is going to handle workflow and communication for use a BOOKING leadType with appropriate status.
See examples of POST request for more information like sample payloads of requests and responses to them.
PMP UI originating leads
Leads created through Hostfully API
Blocks imported from airbnb listings
Channels originating leads
Available statuses for given leadType
NEW, ON_HOLD, QUOTE_SENT, HOLD_EXPIRED, CLOSED_QUOTE, CLOSED_HOLD, PENDING,
BOOKED_BY_AGENT, BOOKED_BY_CUSTOMER, BOOKED_EXTERNALLY, CANCELLED, CANCELLED_BY_TRAVELER, CANCELLED_BY_OWNER STAY - ongoing booking ARCHIVED - past booking
PAID_IN_FULL - deprecated, equivalent to BOOKED
DUPLICATE, IGNORED, SAMPLE
Leads workflow diagram
Hostfully PMP recognizes 3 types of leads.
BLOCK is only to block the availability. It's a typical CRUDL resource related to a property.
- OWNER BLOCK will have ownerUid exposed in the lead details.
INQUIRY and BOOKING on the other hand embed a lot of business logic.
Inquiry goes through a workflow of actions to confirm it into a booking. Once inquiry becomes a booking, there's no way to turn it back into an inquiry. Such booking can only be cancelled if needed.
The diagram below illustrates the workflow of inquiries and bookings.