Add item

addItem appends or inserts any supported Forms item.

Example

import { automation, onHttpRequest } from "automate.ax"
import { addItem } from "automate.ax/google-forms"

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

  addItem({
    form: "form-id",
    item: {
      type: "grid",
      title: "Rate the product",
      gridType: "multipleChoice",
      columns: ["Poor", "Good", "Excellent"],
      rows: [{ title: "Speed", required: true }, { title: "Reliability" }],
    },
  })
})

Inputs

form and item are required. position is a one-based insertion position; omit it to append. requiredRevisionId enables optimistic concurrency.

Item types

question: title, optional description/grading, and a typed question from Add question.
grid: columns, gridType: "multipleChoice" | "checkbox", and rows with title, optional required and questionId; shuffleRows is optional.
pageBreak or text: optional title and description.
image: public sourceUrl, optional altText, alignment, width 1–740, title, and description.
video: YouTube youtubeUrl, optional caption, alignment, width 1–740, title, and description.

account optionally selects the Google account binding.

Output

Returns the complete updated Form, including provider-generated IDs. Images must be reachable by Google and videos must use a YouTube watch or share URL.

Get started

Concepts

Reference

Example

Inputs

Item types

Output

​Example

​Inputs

​Item types

​Output

Example

Inputs

Item types

Output