---
title: ChannelCreatePayload - GraphQL Admin
description: Return type for `channelCreate` mutation.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/ChannelCreatePayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/ChannelCreatePayload.md
api_name: admin
api_type: graphql
type: payload
metadata:
  domain: admin
---

# Channel​Create​Payload

payload

Return type for `channelCreate` mutation.

## Fields

* channel

  [Channel](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel)

  The channel that was created.

* user​Errors

  [\[Channel​Create​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ChannelCreateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [channel​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/channelCreate)

  mutation

  Creates a [`Channel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel) representing a connection between the shop and an external selling platform account. Use this mutation after a merchant authenticates with an external platform to establish the publishing destination for product syndication and, for order-generating channels, order import.

  The platform resolves the [channel specification](https://shopify.dev/docs/apps/build/sales-channels/channel-config-extension) identified by `specificationHandle`, determines its country coverage, intersects with the shop's available region markets, and establishes product feeds for all matching regions. Product feeds immediately begin emitting events to the application's webhook or event subscription.

  If the specification sets `expects_online_store_parity` and no matching region markets exist, the mutation returns an error. If the specification doesn't require online store parity and no matching region markets exist, a channel subordinate to shop defaults is created automatically.

  * input

    [Channel​Create​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ChannelCreateInput)

    required

    ### Arguments

    The input fields for creating the channel.

  ***

***

## Map

### Mutations with this payload

* [channel​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/channelCreate)