Method: forms.create

Create a new form using the title given in the provided form message 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.

Query parameters

Parameters
unpublished

boolean

Optional. Whether the form is unpublished. 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.

Authorization 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 Authorization guide.