How to make a quiz with scoring

Build & score

Short answer: describe the quiz to an AI assistant that's connected to QuizGen and it hands back a live link — scoring included — in under a minute. If you'd rather build it yourself, it's one JSON POST. Both paths below, plus when a spreadsheet-style tool is honestly the better pick.

A "quiz with scoring" means every answer is worth points, each response gets a total score, and the result the respondent sees (and the result you see) depends on that score. That covers graded tests ("7/10 correct"), lead qualification ("score ≥ 4 → book a call"), and "which one are you" quizzes (buckets instead of grades).

Fastest: ask an AI assistant

If you use Claude or ChatGPT, you don't need to build anything. Connect QuizGen's MCP server (https://quizgen.dev/mcp) and say:

Make me a 5-question quiz on food safety basics. Each question is worth 1 point. 4 or more correct shows "Passed", below that shows "Review and retake". Send me the link and tell me how people score.

The assistant creates a real hosted quiz at a short URL like https://quizgen.dev/q/x7km2p — mobile-friendly, autosaving, no account needed for respondents — and can read the scores back to you later in the same chat. Setup steps are in the Claude guide and the ChatGPT guide.

Do it yourself: one POST

Scoring lives in the outcomes block. Points map each question's answer values to points; buckets turn the total into a result screen. POST this body to https://quizgen.dev/api/v1/quizzes:

{
  "schema_version": 1,
  "kind": "quiz",
  "title": "Food safety basics",
  "sections": [
    { "key": "main", "questions": [
      { "id": "fridge_temp", "type": "choice",
        "prompt": "A fridge should be at or below…",
        "options": [
          { "value": "40f", "label": "40°F / 4°C" },
          { "value": "50f", "label": "50°F / 10°C" },
          { "value": "60f", "label": "60°F / 15°C" } ] },
      { "id": "wash_hands", "type": "yes_no",
        "prompt": "Wash hands before handling raw food?" }
    ] }
  ],
  "outcomes": {
    "method": "points",
    "points": {
      "fridge_temp": { "40f": 1, "50f": 0, "60f": 0 },
      "wash_hands": { "yes": 1, "no": 0 }
    },
    "buckets": [
      { "key": "passed", "min": 2, "title": "Passed",
        "body": "Nice — you know your basics." },
      { "key": "retake", "max": 1, "title": "Review and retake",
        "body": "A couple of gaps — skim the guide and try again." }
    ]
  }
}

The response includes the live url. Unauthorized you get a sandbox quiz (72 hours, 10 responses) plus a claim link; authorized, it's permanent. Correct-answer grading and weighted scoring are the same mechanism — just vary the point values.

See their results

Every stored response carries score and outcome:

  • GET /quizzes/:id/responses — each answer set with its score and bucket.
  • GET /quizzes/:id/stats — views, completion rate, and a per-outcome breakdown ("how many passed?").
  • A webhook — each completed response POSTs itself to your endpoint, score included, so you can route qualified to Slack or a CRM without polling.

Respondents see the bucket you defined (title, body, optional redirect_url — useful for "you passed → here's the certificate link").

When something else is the better tool

Honest answers, since "quiz with scoring" covers several jobs:

  • Google Forms — free, and fine if you want to hand-build a basic graded quiz in a visual editor and read results in a spreadsheet. No score-based result screens beyond right/wrong review, and webhooks require Apps Script.
  • Typeform — the polished conversational look, score and outcome quizzes included, built in an editor rather than from JSON. Costs more, and there's no sandbox-style instant API path.
  • Kahoot / Quizizz — live, projected classroom quizzes. Different job: synchronous play, not a link you send out and collect scores from.

Pick QuizGen when you want an AI assistant or your own code to build the quiz, score it server-side, and hand the results to you or your systems. The full comparison: best quiz makers with scoring.

FAQ

Can different questions be worth different points? Yes — point values are per answer value, so a hard question can be worth 5 and an easy one 1.

Can I score a personality quiz instead of a graded one? Same engine, different buckets — see personality quiz with outcomes.

Do respondents need an account? No. They open the link, answer, and see their result. Progress autosaves.

Is it free? The sandbox needs no account at all; the free plan covers 3 live quizzes. Details: free AI quiz generator.

$ curl quizgen.dev/blog/how-to-make-a-quiz-with-scoring.md

This guide as raw markdown — no HTML for your agent to parse.

View .md

Keep reading