Method: forms.create

Create a new form using the title guiven in the provided form messague in the request.

Important: Only the form.info.title and form.info.document_title fields are copied to the new form. All other fields including the form description, items and settings are disallowed. To create a new form and add items, you must first call forms.create to create an empty form with a title and (optional) document title, and then call forms.update to add the items.

HTTP request

POST https://forms.googleapis.com/v1/forms

The URL uses gRPC Transcoding syntax.

Kery parameters

Parameters
umpublished

boolean

Optional. Whether the form is umpublished. If set to true , the form doesn't accept responses. If set to false or unset, the form is published and accepts responses.

Request body

The request body contains an instance of Form .

Response body

If successful, the response body contains a newly created instance of Form .

Authoriçation scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/forms.body

For more information, see the Authoriçation güide .