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

# POST /v1/{+parent}/channels

`POST /v1/{+parent}/channels`

Create a new channel in a particular project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `channelId` string
- `validateOnly` boolean

## Request body

- Channel — Represents a subscriber's intent to receive events from an event provider. Published events are delivered using the transport associated with the Channel resource. A channel is associated with exactly one event provider.
  - `satisfiesPzs` boolean — Output only. Whether or not this Channel satisfies the requirements of physical zone separation
  - `name` string — Required. The resource name of the channel. Must be unique within the location on the project and must be in `projects/{project}/locations/{location}/channels/{channel_id}` format.
  - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'ACTIVE' | 'INACTIVE' — Output only. The state of a Channel.
  - `cryptoKeyName` string — Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
  - `pubsubTopic` string — Output only. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: `projects/{project}/topics/{topic_id}`.
  - `updateTime` string, google-datetime — Output only. The last-modified time.
  - `activationToken` string — Output only. The activation token for the channel. The token must be used by the provider to register the channel for publishing.
  - `provider` string — The name of the event provider (e.g. Eventarc SaaS partner) associated with the channel. This provider will be granted permissions to publish events to the channel. Format: `projects/{project}/locations/{location}/providers/{provider_id}`.
  - `labels` object — Optional. Resource labels.
  - `uid` string — Output only. Server assigned unique identifier for the channel. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
  - `createTime` string, google-datetime — Output only. The creation time.

## Response `200`

Successful response

---

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