Method: accounts.notificationsubscriptions.create
Creates a notification subscription for a business. For standalone or subaccounts accounts, the business can create a subscription for self. For MCAs, the business can create a subscription for all managed accounts or for a specific subaccount.
We will allow the following types of notification subscriptions to exist together (per business as a subscriber per event type):
Subscription for all managed accounts + subscription for self.
Multiple "partial" subscriptions for managed accounts + subscription for self.
we will not allow (per business as a subscriber per event type):
Multiple self subscriptions.
Multiple "all managed accounts" subscriptions.
"All managed accounts" subscription and partial subscriptions at the same time.
Multiple partial subscriptions for the same target account.
HTTP request
POST https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
parent |
string
Required. The merchant account that owns the new notification subscription. Format: accounts/{account}
|
Request body
The request body contains an instance of NotificationSubscription
.
Response body
If successful, the response body contains a newly created instance of NotificationSubscription
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-01-23 UTC.
[null,null,["Last updated 2025-01-23 UTC."],[[["This API creates notification subscriptions for businesses, allowing them to receive updates on various events."],["Businesses can create subscriptions for themselves, all managed accounts, or specific sub-accounts, with certain restrictions to avoid redundancy."],["The API requires a POST request to a specific URL with the merchant account ID and a request body containing the subscription details."],["A successful response will return the newly created notification subscription details."],["Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope."]]],["This describes how to create a notification subscription for a business via a `POST` request to `https://merchantapi.googleapis.com/notifications/v1beta/{parent=accounts/*}/notificationsubscriptions`. The request uses a `parent` path parameter specifying the merchant account. The request and response bodies are `NotificationSubscription` instances. Subscriptions can be for self or managed accounts, with restrictions preventing multiple full or partial subscriptions of the same type. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"]]