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):

  1. Subscription for all managed accounts + subscription for self.

  2. Multiple "partial" subscriptions for managed accounts + subscription for self.

we will not allow (per business as a subscriber per event type):

  1. Multiple self subscriptions.

  2. Multiple "all managed accounts" subscriptions.

  3. "All managed accounts" subscription and partial subscriptions at the same time.

  4. Multiple partial subscriptions for the same target account.

HTTP request

POST https://merchantapi.googleapis.com/notifications/v1/{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.