Add --for-client flag for client transfer store creation

tizmagik · claude · tizmagik · commit cb11b50a2c31 · 2026-04-13T16:44:32.000-04:00
Adds support for creating client transfer stores via the Organizations
API `createClientDevelopmentShop` mutation. These are stores built by
partners for their clients, on the affiliate plan.

Usage: shopify store create --for-client --org &lt;org-id&gt; --name "Store"

The --org flag is required with --for-client and provides the Partner
organization ID. Uses Business Platform token auth via the Organizations
API (different from the Signups API path used by trial/dev stores).

Also adds flag validation:
- --for-client and --dev are mutually exclusive
- --subdomain is not supported with --for-client
- --org is required with --for-client

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/docs-shopify.dev/commands/interfaces/store-create.interface.ts b/docs-shopify.dev/commands/interfaces/store-create.interface.ts
@@ -1,4 +1,8 @@
 // This is an autogenerated file. Don't edit this file manually.
+/**
+ * The following flags are available for the `store create` command:
+ * @publicDocs
+ */
 export interface storecreate {
   /**
    * The country code for the store (e.g., US, CA, GB).
@@ -12,6 +16,12 @@ export interface storecreate {
    */
   '--dev'?: ''
 
+  /**
+   * Create a client transfer store under a Partner organization.
+   * @environment SHOPIFY_FLAG_STORE_FOR_CLIENT
+   */
+  '--for-client'?: ''
+
   /**
    * Output the result as JSON. Automatically disables color output.
    * @environment SHOPIFY_FLAG_JSON
@@ -30,6 +40,12 @@ export interface storecreate {
    */
   '--no-color'?: ''
 
+  /**
+   * The Partner organization ID to create the store under. Required with --for-client.
+   * @environment SHOPIFY_FLAG_STORE_ORG
+   */
+  '--org <value>'?: string
+
   /**
    * The custom myshopify.com subdomain for the store.
    * @environment SHOPIFY_FLAG_STORE_SUBDOMAIN
diff --git a/docs-shopify.dev/commands/store-create.doc.ts b/docs-shopify.dev/commands/store-create.doc.ts
@@ -5,7 +5,7 @@ const data: ReferenceEntityTemplateSchema = {
   name: 'store create',
   description: `Creates a new Shopify store associated with your account.
 
-By default, creates a trial store. Use \`--dev\` to create a development store instead.`,
+By default, creates a trial store. Use \`--dev\` to create a development store, or \`--for-client\` to create a client transfer store under a Partner organization.`,
   overviewPreviewDescription: `Create a new Shopify store.`,
   type: 'command',
   isVisualComponent: false,
diff --git a/docs-shopify.dev/generated/generated_docs_data.json b/docs-shopify.dev/generated/generated_docs_data.json
diff --git a/packages/cli/README.md b/packages/cli/README.md
@@ -2088,15 +2088,20 @@ Create a new Shopify store.
 
 ```
 USAGE
-  $ shopify store create [-c <value>] [--dev] [-j] [-n <value>] [--no-color] [--subdomain <value>] [--verbose]
+  $ shopify store create [-c <value>] [--dev] [--for-client] [-j] [-n <value>] [--no-color] [--org <value>]
+    [--subdomain <value>] [--verbose]
 
 FLAGS
   -c, --country=<value>    [default: US, env: SHOPIFY_FLAG_STORE_COUNTRY] The country code for the store (e.g., US, CA,
                            GB).
   -j, --json               [env: SHOPIFY_FLAG_JSON] Output the result as JSON. Automatically disables color output.
   -n, --name=<value>       [env: SHOPIFY_FLAG_STORE_NAME] The name of the store.
       --dev                [env: SHOPIFY_FLAG_STORE_DEV] Create a development store instead of a trial store.
+      --for-client         [env: SHOPIFY_FLAG_STORE_FOR_CLIENT] Create a client transfer store under a Partner
+                           organization.
       --no-color           [env: SHOPIFY_FLAG_NO_COLOR] Disable color output.
+      --org=<value>        [env: SHOPIFY_FLAG_STORE_ORG] The Partner organization ID to create the store under. Required
+                           with --for-client.
       --subdomain=<value>  [env: SHOPIFY_FLAG_STORE_SUBDOMAIN] The custom myshopify.com subdomain for the store.
       --verbose            [env: SHOPIFY_FLAG_VERBOSE] Increase the verbosity of the output.
 
@@ -2105,7 +2110,8 @@ DESCRIPTION
 
   Creates a new Shopify store associated with your account.
 
-  By default, creates a trial store. Use `--dev` to create a development store instead.
+  By default, creates a trial store. Use `--dev` to create a development store, or `--for-client` to create a client
+  transfer store under a Partner organization.
 
 EXAMPLES
   $ shopify store create
@@ -2114,6 +2120,8 @@ EXAMPLES
 
   $ shopify store create --name "My Dev Store" --dev
 
+  $ shopify store create --name "Client Store" --for-client --org 12345
+
   $ shopify store create --name "My Store" --json
 ```
 
diff --git a/packages/cli/oclif.manifest.json b/packages/cli/oclif.manifest.json
@@ -5807,13 +5807,14 @@
       ],
       "args": {
       },
-      "description": "Creates a new Shopify store associated with your account.\n\nBy default, creates a trial store. Use `--dev` to create a development store instead.",
-      "descriptionWithMarkdown": "Creates a new Shopify store associated with your account.\n\nBy default, creates a trial store. Use `--dev` to create a development store instead.",
+      "description": "Creates a new Shopify store associated with your account.\n\nBy default, creates a trial store. Use `--dev` to create a development store, or `--for-client` to create a client transfer store under a Partner organization.",
+      "descriptionWithMarkdown": "Creates a new Shopify store associated with your account.\n\nBy default, creates a trial store. Use `--dev` to create a development store, or `--for-client` to create a client transfer store under a Partner organization.",
       "enableJsonFlag": false,
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --name \"My Store\" --country US",
         "<%= config.bin %> <%= command.id %> --name \"My Dev Store\" --dev",
+        "<%= config.bin %> <%= command.id %> --name \"Client Store\" --for-client --org 12345",
         "<%= config.bin %> <%= command.id %> --name \"My Store\" --json"
       ],
       "flags": {
@@ -5834,6 +5835,13 @@
           "name": "dev",
           "type": "boolean"
         },
+        "for-client": {
+          "allowNo": false,
+          "description": "Create a client transfer store under a Partner organization.",
+          "env": "SHOPIFY_FLAG_STORE_FOR_CLIENT",
+          "name": "for-client",
+          "type": "boolean"
+        },
         "json": {
           "allowNo": false,
           "char": "j",
@@ -5860,6 +5868,14 @@
           "name": "no-color",
           "type": "boolean"
         },
+        "org": {
+          "description": "The Partner organization ID to create the store under. Required with --for-client.",
+          "env": "SHOPIFY_FLAG_STORE_ORG",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "org",
+          "type": "option"
+        },
         "subdomain": {
           "description": "The custom myshopify.com subdomain for the store.",
           "env": "SHOPIFY_FLAG_STORE_SUBDOMAIN",
diff --git a/packages/cli/src/cli/commands/store/create.test.ts b/packages/cli/src/cli/commands/store/create.test.ts
@@ -23,6 +23,8 @@ describe('store create command', () => {
       subdomain: undefined,
       country: 'US',
       dev: false,
+      forClient: false,
+      org: undefined,
     })
   })
 
@@ -33,13 +35,34 @@ describe('store create command', () => {
       shopLoginUrl: null,
     })
 
-    await StoreCreate.run(['--name', 'Custom Store', '--subdomain', 'custom', '--country', 'CA', '--dev'])
+    await StoreCreate.run(['--name', 'Custom Store', '--subdomain', 'custom', '--country', 'CA'])
 
     expect(createStore).toHaveBeenCalledWith({
       name: 'Custom Store',
       subdomain: 'custom',
       country: 'CA',
-      dev: true,
+      dev: false,
+      forClient: false,
+      org: undefined,
+    })
+  })
+
+  test('passes --for-client and --org flags through to the create service', async () => {
+    vi.mocked(createStore).mockResolvedValue({
+      shopPermanentDomain: 'client-store.myshopify.com',
+      polling: false,
+      shopLoginUrl: null,
+    })
+
+    await StoreCreate.run(['--name', 'Client Store', '--for-client', '--org', '12345'])
+
+    expect(createStore).toHaveBeenCalledWith({
+      name: 'Client Store',
+      subdomain: undefined,
+      country: 'US',
+      dev: false,
+      forClient: true,
+      org: '12345',
     })
   })
 
@@ -90,6 +113,8 @@ describe('store create command', () => {
     expect(StoreCreate.flags.subdomain).toBeDefined()
     expect(StoreCreate.flags.country).toBeDefined()
     expect(StoreCreate.flags.dev).toBeDefined()
+    expect(StoreCreate.flags['for-client']).toBeDefined()
+    expect(StoreCreate.flags.org).toBeDefined()
     expect(StoreCreate.flags.json).toBeDefined()
   })
 })
diff --git a/packages/cli/src/cli/commands/store/create.ts b/packages/cli/src/cli/commands/store/create.ts
@@ -10,14 +10,15 @@ export default class StoreCreate extends Command {
 
   static descriptionWithMarkdown = `Creates a new Shopify store associated with your account.
 
-By default, creates a trial store. Use \`--dev\` to create a development store instead.`
+By default, creates a trial store. Use \`--dev\` to create a development store, or \`--for-client\` to create a client transfer store under a Partner organization.`
 
   static description = this.descriptionWithoutMarkdown()
 
   static examples = [
     '<%= config.bin %> <%= command.id %>',
     '<%= config.bin %> <%= command.id %> --name "My Store" --country US',
     '<%= config.bin %> <%= command.id %> --name "My Dev Store" --dev',
+    '<%= config.bin %> <%= command.id %> --name "Client Store" --for-client --org 12345',
     '<%= config.bin %> <%= command.id %> --name "My Store" --json',
   ]
 
@@ -44,6 +45,15 @@ By default, creates a trial store. Use \`--dev\` to create a development store i
       env: 'SHOPIFY_FLAG_STORE_DEV',
       default: false,
     }),
+    'for-client': Flags.boolean({
+      description: 'Create a client transfer store under a Partner organization.',
+      env: 'SHOPIFY_FLAG_STORE_FOR_CLIENT',
+      default: false,
+    }),
+    org: Flags.string({
+      description: 'The Partner organization ID to create the store under. Required with --for-client.',
+      env: 'SHOPIFY_FLAG_STORE_ORG',
+    }),
   }
 
   async run(): Promise<void> {
@@ -54,6 +64,8 @@ By default, creates a trial store. Use \`--dev\` to create a development store i
       subdomain: flags.subdomain,
       country: flags.country,
       dev: flags.dev,
+      forClient: flags['for-client'],
+      org: flags.org,
     })
 
     if (flags.json) {
diff --git a/packages/cli/src/cli/services/store/create/index.test.ts b/packages/cli/src/cli/services/store/create/index.test.ts
diff --git a/packages/cli/src/cli/services/store/create/index.ts b/packages/cli/src/cli/services/store/create/index.ts
