Title
Add Admin API or CLI support for Customer Account API Application Setup URLs in the Headless sales channel
Feature Request
Hi Shopify team,
We are using Shopify’s Headless sales channel for a custom self-hosted storefront deployed outside Oxygen/Hydrogen hosting. Our storefront uses the Customer Account API, and the required callback URLs, JavaScript origins, and logout URLs are configured manually in:
Shopify Admin -> Sales channels -> Headless -> [storefront] -> Customer Account API credentials -> Application setup
We are building a PR preview infrastructure where every pull request can deploy to an ephemeral preview URL, for example:
https://pr-123.preview.example.com
For the Customer Account login to work on these preview URLs, we need to add the preview URL to the Headless channel’s Customer Account API Application setup.
Today, Shopify appears to support this type of automation only for the Hydrogen sales channel through:
hydrogenStorefrontCustomerApplicationUrlsReplace
shopify hydrogen customer-account-push
However, we do not use the Hydrogen sales channel for this storefront. We use the Headless sales channel with a custom Fly.io deployment. Shopify support confirmed there is currently no documented Admin GraphQL mutation or Shopify CLI command for updating Customer Account API Application setup URLs for a Headless sales channel storefront.
Requested capability
Please add a supported Admin API mutation and/or Shopify CLI command that allows apps or CI/CD workflows to manage Customer Account API Application setup URLs for Headless sales channel storefronts.
Ideally, this would support:
- Reading current allowed JavaScript origins, callback URLs, and logout URLs.
- Adding preview URLs safely.
- Removing stale preview URLs safely.
- Targeting a specific Headless sales channel storefront.
- Using a standard Admin API access token with appropriate scopes.
- Clear validation and error messages for invalid domains or unsupported storefront IDs.
Use case
For PR previews and other ephemeral environments, teams need a Customer Account login to work before code is merged to staging or production. Without API/CLI support, developers must manually add and remove preview URLs in Shopify Admin for every PR that needs account login testing.
That manual process is error-prone and does not scale well for teams using modern preview deployments.
Why Hydrogen-only support is not enough
The existing Hydrogen mutation/CLI path requires a Hydrogen storefront ID and Hydrogen sales channel access. Headless storefronts are also a first-class Shopify pattern, and many teams deploy them to external infrastructure such as Fly.io, Vercel, Netlify, AWS, or Kubernetes.
Those Headless storefronts need the same Customer Account URL management capabilities as Hydrogen storefronts.
Expected outcome
A supported Headless equivalent of the Hydrogen Customer Account URL management API/CLI, so CI/CD systems can safely sync preview/staging/production URLs without migrating to the Hydrogen sales channel solely for automation.
Thanks.