---
title: "POST /v1/admin/{+parent}/subscriptions"
method: POST
path: "/v1/admin/{+parent}/subscriptions"
tags: ["admin"]
---

# POST /v1/admin/{+parent}/subscriptions

`POST /v1/admin/{+parent}/subscriptions`

Creates a new subscription.

## Path parameters

- `parent` string, required

## Query parameters

- `skipBacklog` boolean
- `subscriptionId` string

## Request body

- Subscription — Metadata about a subscription resource.
  - `topic` string — The name of the topic this subscription is attached to. Structured like: projects/{project_number}/locations/{location}/topics/{topic_id}
  - `name` string — The name of the subscription. Structured like: projects/{project_number}/locations/{location}/subscriptions/{subscription_id}
  - `deliveryConfig` DeliveryConfig — The settings for a subscription's message delivery.
    - `deliveryRequirement` 'DELIVERY_REQUIREMENT_UNSPECIFIED' | 'DELIVER_IMMEDIATELY' | 'DELIVER_AFTER_STORED' — The DeliveryRequirement for this subscription.
  - `exportConfig` ExportConfig — Configuration for a Pub/Sub Lite subscription that writes messages to a destination. User subscriber clients must not connect to this subscription.
    - `desiredState` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'PERMISSION_DENIED' | 'NOT_FOUND' — The desired state of this export. Setting this to values other than `ACTIVE` and `PAUSED` will result in an error.
    - `currentState` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'PERMISSION_DENIED' | 'NOT_FOUND' — Output only. The current state of the export, which may be different to the desired state due to errors. This field is output only.
    - `deadLetterTopic` string — Optional. The name of an optional Pub/Sub Lite topic to publish messages that can not be exported to the destination. For example, the message can not be published to the Pub/Sub service because it does not satisfy the constraints documented at https://cloud.google.com/pubsub/docs/publisher. Structured like: projects/{project_number}/locations/{location}/topics/{topic_id}. Must be within the same project and location as the subscription. The topic may be changed or removed.
    - `pubsubConfig` PubSubConfig — Configuration for exporting to a Pub/Sub topic.
      - `topic` string — The name of the Pub/Sub topic. Structured like: projects/{project_number}/topics/{topic_id}. The topic may be changed.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/pubsublite.md) · [All operations](https://skmtc.net/google/apis/pubsublite/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/pubsublite/versions/d973df9a0149/schema)