Method: projects.contacts.compute

Lists all contacts for the resource that are subscribed to the specified notification categories, including contacts inherited from any parent resources.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The name of the resource to compute contacts for. Format: organizations/{organization_id}, folders/{folder_id} or projects/{project_id}

Authorization requires the following IAM permission on the specified resource parent:

  • essentialcontacts.contacts.list

Query parameters


enum (NotificationCategory)

The categories of notifications to compute contacts for. If ALL is included in this list, contacts subscribed to any notification category will be returned.



Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available. If not specified, the default pageSize is 100.



Optional. If present, retrieves the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.

Request body

The request body must be empty.

Response body

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

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.