Method: properties.userLinks.batchCreate

Creates information about multiple users' links to an account or property.

This method is transactional. If any UserLink cannot be created, none of the UserLinks will be created.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The account or property that all user links in the request are for. This field is required. The parent field in the CreateUserLinkRequest messages must either be empty or match this field. Example format: accounts/1234

Request body

The request body contains data with the following structure:

JSON representation
  "notifyNewUsers": boolean,
  "requests": [
      object (CreateUserLinkRequest)


Optional. If set, then email the new users notifying them that they've been granted permissions to the resource. Regardless of whether this is set or not, notifyNewUser field inside each individual request is ignored.


object (CreateUserLinkRequest)

Required. The requests specifying the user links to create. A maximum of 1000 user links can be created in a batch.

Response body

If successful, the response body contains an instance of BatchCreateUserLinksResponse.

Authorization scopes

Requires the following OAuth scope: