Testimonial form: collect a quote, a rating and permission

A kind message arrives as a direct message and vanishes under other messages. When you want a quote for your site, you have to ask again. I would rather collect the words and the permission in one go, while the customer is still happy.

Use this when

A customer has just said thank you.
You need a quote, a name and permission in the same place.

Skip it when

You want reviews on a marketplace. Those live in their own system.
You want a long customer story with background and results. That needs a longer form.

What is asked and why

The name and the purchase set the context. A star rating and one sentence give you a headline. The longer text is the body. The credit choice and the publish tick stop you using a name someone did not agree to. A photo link and a profile link are optional extras.

What a customer's AI would ask

"What did you buy or hire us for?" Then "How would you rate it?" Then "How should we credit you?" It shows the answers and sends only after a yes. See agent-fillable forms.

Find more in forms for agencies and forms for online stores. A referral form turns a happy customer into introductions. A website feedback form shows how visitors react to the quotes you publish.

Questions

Can I edit a testimonial before I publish it?

Trim it for length and fix typos, but do not change the meaning. If you change more, send the new text back to the customer for a yes.

How do I collect them after every order?

Share the same link in your follow-up message or your site footer. Every response is a row, so sort by star rating and pick quotes from the top.

What if someone leaves a low rating?

Read it. A low rating with a clear note is useful feedback. You choose what to publish, and the publish tick records which customers agreed.

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": "Share a few words about us",
  "description": "Your words help the next person decide. Two lines are plenty, and you choose how you are named.",
  "fields": [
    {
      "id": "reviewer_name",
      "label": "Your name",
      "type": "short_text",
      "required": true,
      "max_length": 120
    },
    {
      "id": "reviewer_email",
      "label": "Email",
      "type": "email"
    },
    {
      "id": "what_you_bought",
      "label": "What did you buy or hire us for?",
      "type": "short_text",
      "required": true,
      "max_length": 200
    },
    {
      "id": "star_rating",
      "label": "How would you rate it?",
      "type": "rating",
      "required": true,
      "min": 1,
      "max": 5
    },
    {
      "id": "one_sentence",
      "label": "Sum it up in one sentence",
      "type": "short_text",
      "max_length": 200
    },
    {
      "id": "testimonial_text",
      "label": "Your testimonial",
      "type": "long_text",
      "required": true,
      "max_length": 1000
    },
    {
      "id": "what_was_different",
      "label": "What was different afterwards?",
      "type": "long_text",
      "max_length": 800
    },
    {
      "id": "recommend_to",
      "label": "Who would you recommend us to?",
      "type": "single_choice",
      "options": [
        "Anyone",
        "Friends and family",
        "Businesses like mine",
        "I am not sure"
      ]
    },
    {
      "id": "credit_as",
      "label": "How should we credit you?",
      "type": "single_choice",
      "required": true,
      "options": [
        "Full name",
        "First name and last initial",
        "First name only",
        "Anonymous"
      ]
    },
    {
      "id": "display_title",
      "label": "Job title or company, if you want it shown",
      "type": "short_text",
      "max_length": 150
    },
    {
      "id": "photo_link",
      "label": "Link to a photo of you or your purchase",
      "type": "url"
    },
    {
      "id": "profile_link",
      "label": "Link to your site or profile",
      "type": "url"
    },
    {
      "id": "publish_ok",
      "label": "You may publish my words on your website and social pages",
      "type": "checkbox",
      "required": true
    }
  ]
}

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":"Share a few words about us","description":"Your words help the next person decide. Two lines are plenty, and you choose how you are named.","fields":[{"id":"reviewer_name","label":"Your name","type":"short_text","required":true,"max_length":120},{"id":"reviewer_email","label":"Email","type":"email"},{"id":"what_you_bought","label":"What did you buy or hire us for?","type":"short_text","required":true,"max_length":200},{"id":"star_rating","label":"How would you rate it?","type":"rating","required":true,"min":1,"max":5},{"id":"one_sentence","label":"Sum it up in one sentence","type":"short_text","max_length":200},{"id":"testimonial_text","label":"Your testimonial","type":"long_text","required":true,"max_length":1000},{"id":"what_was_different","label":"What was different afterwards?","type":"long_text","max_length":800},{"id":"recommend_to","label":"Who would you recommend us to?","type":"single_choice","options":["Anyone","Friends and family","Businesses like mine","I am not sure"]},{"id":"credit_as","label":"How should we credit you?","type":"single_choice","required":true,"options":["Full name","First name and last initial","First name only","Anonymous"]},{"id":"display_title","label":"Job title or company, if you want it shown","type":"short_text","max_length":150},{"id":"photo_link","label":"Link to a photo of you or your purchase","type":"url"},{"id":"profile_link","label":"Link to your site or profile","type":"url"},{"id":"publish_ok","label":"You may publish my words on your website and social pages","type":"checkbox","required":true}]}'

JSON definition

json

{
  "title": "Share a few words about us",
  "description": "Your words help the next person decide. Two lines are plenty, and you choose how you are named.",
  "fields": [
    {
      "id": "reviewer_name",
      "label": "Your name",
      "type": "short_text",
      "required": true,
      "max_length": 120
    },
    {
      "id": "reviewer_email",
      "label": "Email",
      "type": "email"
    },
    {
      "id": "what_you_bought",
      "label": "What did you buy or hire us for?",
      "type": "short_text",
      "required": true,
      "max_length": 200
    },
    {
      "id": "star_rating",
      "label": "How would you rate it?",
      "type": "rating",
      "required": true,
      "min": 1,
      "max": 5
    },
    {
      "id": "one_sentence",
      "label": "Sum it up in one sentence",
      "type": "short_text",
      "max_length": 200
    },
    {
      "id": "testimonial_text",
      "label": "Your testimonial",
      "type": "long_text",
      "required": true,
      "max_length": 1000
    },
    {
      "id": "what_was_different",
      "label": "What was different afterwards?",
      "type": "long_text",
      "max_length": 800
    },
    {
      "id": "recommend_to",
      "label": "Who would you recommend us to?",
      "type": "single_choice",
      "options": [
        "Anyone",
        "Friends and family",
        "Businesses like mine",
        "I am not sure"
      ]
    },
    {
      "id": "credit_as",
      "label": "How should we credit you?",
      "type": "single_choice",
      "required": true,
      "options": [
        "Full name",
        "First name and last initial",
        "First name only",
        "Anonymous"
      ]
    },
    {
      "id": "display_title",
      "label": "Job title or company, if you want it shown",
      "type": "short_text",
      "max_length": 150
    },
    {
      "id": "photo_link",
      "label": "Link to a photo of you or your purchase",
      "type": "url"
    },
    {
      "id": "profile_link",
      "label": "Link to your site or profile",
      "type": "url"
    },
    {
      "id": "publish_ok",
      "label": "You may publish my words on your website and social pages",
      "type": "checkbox",
      "required": true
    }
  ]
}

Testimonial form that gets the quote and the permission together