Service request form: take repair and service calls in one link

A customer calls, says the tap is dripping and hangs up before you ask where. I would rather have the address, the problem and the urgency in writing before I pick up the phone.

Who it is for

Plumbers, electricians, heating and cooling firms, appliance repairers and handymen who take jobs from homeowners. It also works as a customer service request form for small repair shops.

What each question is for

Contact details and address: to call back and to find the job.
Trade and urgency: tells you who to send and how soon.
Problem and first noticed date: the story behind the call.
Photo link: an album link helps you see the fault.
Entry notes, pets and adult at home: to avoid a wasted trip.
Times to reach them: so your callback lands.

What a customer's AI would ask

"What is the address of the job?" Then "How urgent is it?" Then "When did the problem start?" It shows the answers and sends only after a yes. See agent-fillable forms.

Before you use it

Turn on notify_email so a new request lands in your inbox, then sort the CSV by urgency. Browse forms for home services and trades. A work order request suits jobs that need a written order, a quote request form suits bigger projects, and a booking request suits planned visits.

Questions

Can I get a message when a new request arrives?

Yes. Set notify_email in the form settings and you get a notice in your own inbox. A signed webhook can also fire for each response.

How do I tell emergencies from routine jobs?

The urgency question has four choices. Filter the CSV by that column and call the emergency rows first.

Can customers add photos?

Not as files, because uploads are not supported. The form asks for a link to an album instead, so you still see the fault before you drive out.

Or paste the JSON

Give this to your AI. It needs the AI Form API MCP server or an API key. It makes the form and sends you the link.

text

Create this form with the AI Form API create_form tool (or POST https://aiformapi.com/v1/forms with my API key). Then reply with the public_url.

{
  "title": "Request a service visit",
  "description": "Tell us what is wrong and where. We will read it and call you back.",
  "fields": [
    {
      "id": "customer_name",
      "label": "Your name",
      "type": "short_text",
      "required": true,
      "max_length": 150
    },
    {
      "id": "customer_phone",
      "label": "Your phone",
      "type": "phone",
      "required": true
    },
    {
      "id": "customer_email",
      "label": "Your email",
      "type": "email"
    },
    {
      "id": "job_address",
      "label": "Address where the work is needed",
      "type": "short_text",
      "required": true,
      "max_length": 300
    },
    {
      "id": "trade_needed",
      "label": "What kind of help do you need?",
      "type": "single_choice",
      "required": true,
      "options": [
        "Plumbing",
        "Electrical",
        "Heating and cooling",
        "Appliance repair",
        "General handyman",
        "Roof or gutters",
        "Something else"
      ]
    },
    {
      "id": "how_urgent",
      "label": "How urgent is it?",
      "type": "single_choice",
      "required": true,
      "options": [
        "Emergency, today",
        "This week",
        "In the next few weeks",
        "No rush"
      ]
    },
    {
      "id": "problem_description",
      "label": "What is the problem?",
      "type": "long_text",
      "required": true,
      "max_length": 2000
    },
    {
      "id": "first_noticed",
      "label": "When did you first notice it?",
      "type": "date"
    },
    {
      "id": "photo_album_url",
      "label": "Link to photos of the problem",
      "type": "url",
      "help": "Share a public album link. File uploads are not supported."
    },
    {
      "id": "how_to_get_in",
      "label": "Parking, gate or entry instructions",
      "type": "long_text",
      "max_length": 500
    },
    {
      "id": "pets_on_site",
      "label": "There are pets at the property",
      "type": "checkbox"
    },
    {
      "id": "adult_will_be_home",
      "label": "An adult will be home during the visit",
      "type": "checkbox"
    },
    {
      "id": "callback_windows",
      "label": "When can we reach you?",
      "type": "multi_choice",
      "options": [
        "Morning",
        "Afternoon",
        "Evening",
        "Weekend"
      ]
    }
  ]
}

Or call the API

bash

curl -X POST https://aiformapi.com/v1/forms \
  -H "Authorization: Bearer $AIFORMAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Request a service visit","description":"Tell us what is wrong and where. We will read it and call you back.","fields":[{"id":"customer_name","label":"Your name","type":"short_text","required":true,"max_length":150},{"id":"customer_phone","label":"Your phone","type":"phone","required":true},{"id":"customer_email","label":"Your email","type":"email"},{"id":"job_address","label":"Address where the work is needed","type":"short_text","required":true,"max_length":300},{"id":"trade_needed","label":"What kind of help do you need?","type":"single_choice","required":true,"options":["Plumbing","Electrical","Heating and cooling","Appliance repair","General handyman","Roof or gutters","Something else"]},{"id":"how_urgent","label":"How urgent is it?","type":"single_choice","required":true,"options":["Emergency, today","This week","In the next few weeks","No rush"]},{"id":"problem_description","label":"What is the problem?","type":"long_text","required":true,"max_length":2000},{"id":"first_noticed","label":"When did you first notice it?","type":"date"},{"id":"photo_album_url","label":"Link to photos of the problem","type":"url","help":"Share a public album link. File uploads are not supported."},{"id":"how_to_get_in","label":"Parking, gate or entry instructions","type":"long_text","max_length":500},{"id":"pets_on_site","label":"There are pets at the property","type":"checkbox"},{"id":"adult_will_be_home","label":"An adult will be home during the visit","type":"checkbox"},{"id":"callback_windows","label":"When can we reach you?","type":"multi_choice","options":["Morning","Afternoon","Evening","Weekend"]}]}'

JSON definition

json

{
  "title": "Request a service visit",
  "description": "Tell us what is wrong and where. We will read it and call you back.",
  "fields": [
    {
      "id": "customer_name",
      "label": "Your name",
      "type": "short_text",
      "required": true,
      "max_length": 150
    },
    {
      "id": "customer_phone",
      "label": "Your phone",
      "type": "phone",
      "required": true
    },
    {
      "id": "customer_email",
      "label": "Your email",
      "type": "email"
    },
    {
      "id": "job_address",
      "label": "Address where the work is needed",
      "type": "short_text",
      "required": true,
      "max_length": 300
    },
    {
      "id": "trade_needed",
      "label": "What kind of help do you need?",
      "type": "single_choice",
      "required": true,
      "options": [
        "Plumbing",
        "Electrical",
        "Heating and cooling",
        "Appliance repair",
        "General handyman",
        "Roof or gutters",
        "Something else"
      ]
    },
    {
      "id": "how_urgent",
      "label": "How urgent is it?",
      "type": "single_choice",
      "required": true,
      "options": [
        "Emergency, today",
        "This week",
        "In the next few weeks",
        "No rush"
      ]
    },
    {
      "id": "problem_description",
      "label": "What is the problem?",
      "type": "long_text",
      "required": true,
      "max_length": 2000
    },
    {
      "id": "first_noticed",
      "label": "When did you first notice it?",
      "type": "date"
    },
    {
      "id": "photo_album_url",
      "label": "Link to photos of the problem",
      "type": "url",
      "help": "Share a public album link. File uploads are not supported."
    },
    {
      "id": "how_to_get_in",
      "label": "Parking, gate or entry instructions",
      "type": "long_text",
      "max_length": 500
    },
    {
      "id": "pets_on_site",
      "label": "There are pets at the property",
      "type": "checkbox"
    },
    {
      "id": "adult_will_be_home",
      "label": "An adult will be home during the visit",
      "type": "checkbox"
    },
    {
      "id": "callback_windows",
      "label": "When can we reach you?",
      "type": "multi_choice",
      "options": [
        "Morning",
        "Afternoon",
        "Evening",
        "Weekend"
      ]
    }
  ]
}

Service request form for trades and repair businesses