A front desk for cleaning businesses: firm quotes, open times, reply drafts, follow-ups, bookings and bad-lead credit requests.
This API is for cleaning businesses and needs the pro's Latchbell key. Booking a cleaner for a customer needs no key: read https://slotted.agenthippo.ai/llms.txt. Latchbell Front Desk and Latchbell Local Pros are one system: bookings customers make through Local Pros (or any AI assistant) appear here in schedule and updates.
If you write your own client, prefer the MCP endpoint https://slotted.agenthippo.ai/mcp: JSON-RPC 2.0 over HTTP (initialize, tools/list, tools/call), plain JSON responses, no session or event stream. Listing tools on each call means new operations appear automatically. The REST paths below are equivalent but fixed.
https://slotted.agenthippo.aiAuthorization header as Bearer <key>. paste your Latchbell key (shown at signup; make a new one from your dashboard).https://slotted.agenthippo.ai/openapi.jsonX-Client-Name: <your assistant's name> (for example Muse) so bookings show which assistant made them.GET with query parameters (lists are comma-separated); write endpoints are POST with a JSON body. Errors return {"error": "..."}.Example:
curl -H "Authorization: Bearer YOUR_KEY" "https://slotted.agenthippo.ai/api/v1/my_business"
GET /api/v1/my_business: Show the business profile, prices, add-ons, service ZIPs, booking page and this month's pipeline.POST /api/v1/log_lead: Call this when a new lead arrives (e.g. a Thumbtack, Angi, Bark or Yelp lead email in Gmail, or a Facebook/Instagram message). Returns a firm quote, open times, and a reply draft. For platform leads (Thumbtack, Angi, Bark, Yelp, Google), the customer name and contact are not stored and the reply must be sent inside that platform; never send platform customers links to book elsewhere.GET /api/v1/quote_job: Price a cleaning from the pro's own price list, with the line items and estimated hours.GET /api/v1/open_times: List open start times for a job of this size, given working hours and existing bookings.POST /api/v1/book_job: Book a job on this pro's own schedule, usually for a lead who picked a time. It cannot search or book other cleaners; a customer looking for a cleaner uses Latchbell Local Pros instead. Requires the customer's name, the address, and customer_phone or customer_email. Front desk bookings are free.GET /api/v1/follow_ups_due: List quoted leads that haven't replied and are due a follow-up (after 1 day, then 2 more days), each with a draft. After the pro sends one, call update_lead with contacted=true.POST /api/v1/update_lead: Update a lead: mark a follow-up as sent (contacted=true), or set status to lost/booked, or add notes.POST /api/v1/flag_bad_lead: Mark a paid lead as bad and prepare a lead-credit request with evidence for the pro to submit to the platform themselves.POST /api/v1/cancel_job: Cancel an upcoming job on this pro's schedule (booking id from schedule or book_job). No Latchbell fee is charged for cancelled jobs. Latchbell does not message the customer yet, so tell the pro to let the customer know. Confirm with the pro first.GET /api/v1/updates: Return only what changed since the last check: new bookings (including from AI assistants), cancellations, follow-ups due, jobs today. Pass since = the cursor from the previous call. For a scheduled watcher, check about every next_check_in_minutes, and only message the pro when events is not empty.POST /api/v1/report_no_show: Report that a customer booked through Latchbell did not show up or cancel. The $5 Latchbell fee for that booking is waived.GET /api/v1/pipeline: Monthly report: leads and spend by platform, jobs booked, true cost per booked job, possible lead credits, and customers Latchbell brought directly.GET /api/v1/schedule: Show upcoming jobs (with customer contact and address) and unread notifications such as new bookings from AI agents.MCP clients (Claude, ChatGPT) can use https://slotted.agenthippo.ai/mcp instead.