Maintenance request form template
Let anyone raise a repair with a photo, a location, and enough detail to dispatch on.
10 fields. Free to start. No card, and nothing to install.
Who uses it
Facilities teams, property managers, hotels, schools, and building strata committees. Anyone who owns a building and does not own the phone that keeps ringing about it.
The problem it solves
A broken thing is reported by phone, described badly, and logged as a line of text with no photograph. The technician arrives without the right part and a fifteen minute job becomes two visits.
How this handles it
A photograph is one tap from the camera, so the technician sees the fault before they load the van. The location and the urgency are structured answers, which is what makes automatic dispatch possible instead of a person reading every message. The submission carries a reference the reporter can quote, so the follow-up call is short.
What needs fixing
One photo close in, one showing where it is in the room.
Where it is
How urgent
Who reported it
For agents
What an agent does with this form
A facilities agent triages each new request by category and urgency, then creates the work order in the maintenance system with the photo attached. Emergencies page the on-call technician directly, and everything else joins the queue with its own reference.
The template is published as JSON at
/templates/maintenance-request.json.
Read it to learn every field id, then post values keyed by those ids.
A field id is stable. A label is not.
{
"values": {
"mr_category": "plumbing_or_water",
"mr_description": "A short factual answer.",
"mr_building": "A short factual answer.",
"mr_room": "A short factual answer.",
"mr_access": "open_during_business_hours"
},
"idempotency_key": "maintenance-request-2026-09-09-001",
"agent": {
"name": "your-agent"
}
}Authorization: Bearer ifk_submit_…. Or connect over MCP at /mcp.Questions about maintenance request forms
How does a tenant find the form?
Print the QR code and put it in the lift lobby, the kitchen, and the plant room. A tenant scans it and reports the fault standing in front of it, which is when the photograph is easiest to take.
Can we route emergencies differently?
Yes, through a webhook that reads the urgency field. That field stores a fixed value rather than free text, so a rule on it is reliable rather than a keyword guess.
Does the reporter get a reference?
The confirmation page shows one, and the emailed copy carries it too. Ask reporters to quote it, and a follow-up call starts from the record instead of from a description.
What stops duplicate reports of the same fault?
Nothing at the form, and that is deliberate, since three reports of one leak is a signal about severity. Deduplicate downstream on the building, the room, and the category.
Create this form in your own workspace.
The template loads as a draft. Change every field, or send it as it stands.
Create this form