Direct API
Direct MAX-plan API-key connection
Recommended route
What it does
The receptionist reads Housecall Pro jobs as busy time, matches or creates the caller as a customer, then writes either a scheduled job or a lead according to the mode you choose.
Before you start
Requires a Housecall Pro MAX-plan Admin API key. Paste the key in Integrations and choose Scheduled job or Lead only. Scheduled jobs also need the caller's service address and the business time zone.
What it does not do
Lead mode captures the caller but does not reserve time. Scheduled job mode reports booked only after Housecall Pro returns a job ID. If the address, time zone, or job endpoint cannot support the write, the adapter falls back to a lead and the caller must not be told the appointment is booked.
Set it up
- Create an Admin API key in the customer's Housecall Pro MAX account.
- Open Integrations, paste the key, and choose Scheduled job or Lead only.
- Complete one non-production call with a real service address and appointment time.
- Confirm exactly one customer and the expected job or lead appear in Housecall Pro.