---
title: hydrogenStorefrontCreate - GraphQL Admin
description: >-
  Sets up a new Hydrogen storefront to power your headless commerce experience.
  This mutation kicks off the provisioning process in the background and gives
  you a job ID to track progress.


  For example, when launching a new headless commerce experience, developers use
  this mutation to provision the storefront environment.


  Use `hydrogenStorefrontCreate` to:

  - Provision new Hydrogen storefront instances

  - Track creation progress through background jobs

  - Handle setup validation and error reporting


  The mutation returns immediately with a job ID that can be used to monitor the
  creation progress, as storefront provisioning runs asynchronously. User errors
  provide feedback if the creation request contains invalid parameters or
  conflicts with existing resources.


  Learn more about [creating Hydrogen
  storefronts](https://shopify.dev/docs/custom-storefronts/hydrogen/getting-started).
api_version: unstable
api_name: admin
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/mutations/hydrogenStorefrontCreate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/mutations/hydrogenStorefrontCreate.md
---

# hydrogen​Storefront​Create

mutation

Requires Request must be initiated from the Shopify CLI and user must have full access to apps or access to the Hydrogen channel.

Sets up a new Hydrogen storefront to power your headless commerce experience. This mutation kicks off the provisioning process in the background and gives you a job ID to track progress.

For example, when launching a new headless commerce experience, developers use this mutation to provision the storefront environment.

Use `hydrogenStorefrontCreate` to:

* Provision new Hydrogen storefront instances
* Track creation progress through background jobs
* Handle setup validation and error reporting

The mutation returns immediately with a job ID that can be used to monitor the creation progress, as storefront provisioning runs asynchronously. User errors provide feedback if the creation request contains invalid parameters or conflicts with existing resources.

Learn more about [creating Hydrogen storefronts](https://shopify.dev/docs/custom-storefronts/hydrogen/getting-started).

## Arguments

* title

  [String!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

  required

  The title for the Hydrogen storefront.

***

## Hydrogen​Storefront​Create​Payload returns

* job​Id

  [ID](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

  ID for job that connects the Hydrogen storefront to Oxygen.

* user​Errors

  [\[Hydrogen​Storefront​Create​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/HydrogenStorefrontCreateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### hydrogenStorefrontCreate reference

## Mutation Reference

```graphql
mutation hydrogenStorefrontCreate($title: String!) {
  hydrogenStorefrontCreate(title: $title) {
    jobId
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "title": "<your-title>"
}
```