v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-137516.8 KB
organizations

Adds a new contact for a resource.

post/v1/{+parent}/contacts

Path parameters

parentstring required

Required. The resource to save this contact for. Format: organizations/{organization}, folders/{folder} or projects/{project} (where {project} is the project number)

Request body

namestring

Output only. The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}

emailstring

Required. The email address to send notifications to. The email address does not need to be a Google Account.

notificationCategorySubscriptionsstring[]

Required. The categories of notifications that the contact will receive communications for.

languageTagstring

Required. The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.

validationState'VALIDATION_STATE_UNSPECIFIED' | 'VALID' | 'INVALID'

Output only. The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.

validateTimestring google-datetime

Output only. The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.

Response

Successful response