Method: monetization.subscriptions.create
Stay organized with collections
Save and categorize content based on your preferences.
Creates a new subscription. Newly added base plans will remain in draft state until activated.
HTTP request
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions
The URL uses gRPC Transcoding
syntax.
Path parameters
| Parameters |
packageName
|
string
Required. The parent app (package name) for which the subscription should be created. Must be equal to the packageName field on the Subscription resource.
|
Query parameters
| Parameters |
productId
|
string
Required. The ID to use for the subscription. For the requirements on this format, see the documentation of the productId field on the Subscription resource.
|
regionsVersion
|
object ( RegionsVersion
)
Required. The version of the available regions being used for the subscription.
|
Request body
The request body contains an instance of Subscription
.
Response body
If successful, the response body contains a newly created instance of Subscription
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/androidpublisher
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-05-21 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-21 UTC."],[[["\u003cp\u003eCreates a new subscription for a specified Android app package.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the package name, subscription ID, and regions version in the request.\u003c/p\u003e\n"],["\u003cp\u003eThe newly created subscription will initially be in draft state and needs to be activated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a \u003ccode\u003eSubscription\u003c/code\u003e resource, and a successful response will return the newly created \u003ccode\u003eSubscription\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to create a new subscription using the Android Publisher API. A `POST` request is sent to a specified URL, including the `packageName` in the path. The request requires `productId` and `regionsVersion` as query parameters. The request body contains the `Subscription` to be created. A successful response returns a newly created `Subscription`. The process uses gRPC Transcoding and requires the `androidpublisher` OAuth scope. Newly added base plans are in draft until activated.\n"],null,["# Method: monetization.subscriptions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new subscription. Newly added base plans will remain in draft state until activated.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) for which the subscription should be created. Must be equal to the packageName field on the Subscription resource. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `productId` | `string` Required. The ID to use for the subscription. For the requirements on this format, see the documentation of the productId field on the Subscription resource. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the subscription. |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
