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


Create a new watch. If a watch ID is provided, it must be unused. For each invoking project, the per form limit is one watch per Watch.EventType. A watch expires seven days after it is created (see Watch.expire_time).

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. ID of the Form to watch.

Request body

The request body contains data with the following structure:

JSON representation
  "watch": {
    object (Watch)
  "watchId": string

object (Watch)

Required. The watch object. No ID should be set on this object; use watchId instead.



The ID to use for the watch. If specified, the ID must not already be in use. If not specified, an ID is generated. This value should be 4-63 characters, and valid characters are /[a-z][0-9]-/.

Response body

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

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the OAuth 2.0 Overview.