Subscriptions: delete

Requires authorization

Cancel, suspend, or transfer a subscription to direct. Try it now.


HTTP request

DELETE or suspend


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.
subscriptionId string This is a required property. The subscriptionId is the subscription identifier and is unique for each customer. Since a subscriptionId changes when a subscription is updated, we recommend to not use this ID as a key for persistent data. And the subscriptionId can be found using the retrieve all reseller subscriptions method.
Required query parameters
deletionType string The deletionType query string enables the cancellation, downgrade, or suspension of a subscription.

Acceptable values are:
  • "cancel": Cancels the subscription immediately. This does not apply to a G Suite subscription.
  • "transfer_to_direct": Transfers a subscription directly to Google.  The customer is immediately transferred to a direct billing relationship with Google and is given a short amount of time with no service interruption. The customer can then choose to set up billing directly with Google by using a credit card, or they can transfer to another reseller.


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


Request body

Do not supply a request body with this method.


If successful, this method returns an empty 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.