The Google Forms API is currently in Restricted Beta. To use the API, apply for access at the Early Adopter Program page.

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 field is 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 then call forms.update to add the items.

HTTP request

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

The URL uses gRPC Transcoding syntax.

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/forms.body

For more information, see the OAuth 2.0 Overview.