> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Add question

> Add a typed question to a Google Form.

`addQuestion` is the concise way to add one question item. Use `addItem` for
grids, sections, text, images, or videos.

## Example

```ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { addQuestion } from "automate.ax/google-forms"

export default automation("Add a satisfaction question", () => {
  onHttpRequest({ scope: "automation" })

  addQuestion({
    form: "form-id",
    title: "How satisfied are you?",
    question: {
      type: "scale",
      low: 1,
      high: 5,
      lowLabel: "Not satisfied",
      highLabel: "Very satisfied",
      required: true,
    },
  })
})
```

## Inputs

`form`, `title`, and `question` are required. `description`, optional quiz
`grading`, one-based `position`, and `requiredRevisionId` are optional.
Question types are `shortText`, `paragraph`, `multipleChoice`, `checkbox`,
`dropdown`, `scale`, `date`, `time`, `duration`, and `rating`. Choice questions
require `options`; scale uses `low` 0 or 1 and `high` 2–10; rating uses `icon`
(`star`, `heart`, `thumbUp`) and 3–10 `levels`. Every question can set
`required`; choices can set `shuffle`; date can set `includeTime` and
`includeYear`.

`grading` is `{ correctAnswers: string[]; points: number; generalFeedback?: string; whenRight?: string; whenWrong?: string }`.

`account` optionally selects the Google account binding.

## Output

Returns the complete updated `Form`. Omit `position` to append. A stale
`requiredRevisionId` rejects the write instead of overwriting newer changes.