Method: admin.projects.locations.subscriptions.create

Creates a new subscription.

HTTP request

POST https://{endpoint}/v1/admin/{parent=projects/*/locations/*}/subscriptions

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The parent location in which to create the subscription. Structured like projects/{project_number}/locations/{location}.

Authorization requires the following IAM permission on the specified resource parent:

  • pubsublite.subscriptions.create

Query parameters



Required. The ID to use for the subscription, which will become the final component of the subscription's name.

This value is structured like: my-sub-name.

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:


For more information, see the Authentication Overview.