Subscriptions: insert

Create or transfer a subscription. Try it now.

Create a subscription for a customer's account that you ordered using the Order a new customer account method. For more information about creating a subscription for different payment plans, see manage subscriptions.

If you did not order the customer's account using the customer insert method, use the customer's customerAuthToken when creating a subscription for that customer.

If transferring a G Suite subscription with an associated Google Drive or Google Vault subscription, use the batch operation to transfer all of these subscriptions. For more information, see how to transfer subscriptions.

Request

HTTP request

POST https://www.googleapis.com/apps/reseller/v1/customers/customerId/subscriptions

Parameters

Parameter name	Value	Description
Path parameters
`customerId`	`string`	Either the customer's primary domain name or the customer's unique identifier. If using the domain name, we do not recommend using a `customerId` as a key for persistent data. If the domain name for a `customerId` is changed, the Google system automatically updates.
Optional query parameters
`customerAuthToken`	`string`	The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.

Authorization

This request requires authorization with the following scope (read more about authentication and authorization).

Scope
`https://www.googleapis.com/auth/apps.order`

Request body

In the request body, supply a Subscriptions resource.

Response

If successful, this method returns a Subscriptions resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.