Shopify FlowのflowTriggerReceiveを2024-07のバージョンで実行するとエラーが発生する

Topic summary

Shopify Flowのカスタムトリガー開発中に、API バージョン2024-07でflowTriggerReceiveミューテーションを実行すると「Invalid handle ‘test-handle’」というスキーマ検証エラーが発生する問題が報告されています。

問題の詳細:

  • API バージョン2024-04では正常に動作
  • 公式ドキュメント(https://shopify.dev/docs/apps/build/flow/triggers/create)の手順とGraphQLクエリに従っているが、2024-07では失敗
  • handle値は自動生成されたtomlファイルの設定を参照して正しく入力済み

解決状況:
Shopifyサポートに問い合わせた結果、掲載されている手順およびGraphQLクエリは使用できないことが判明。代替方法として、パートナーダッシュボードからトリガー拡張機能を作成し、その設定ページにあるGraphQLを使用することで動作することを確認(最新APIバージョン2024-07でも有効)。スクリーンショット付きで解決方法が共有されています。

Summarized with AI on November 6. AI used: claude-sonnet-4-5-20250929.

現在、Shopify Flowで利用できるトリガーの開発を進めております。

動作確認として以下のクエリをリクエストすると以下のエラーメッセージが返却されます。

  • クエリ
curl --location 'https://XXX.myshopify.com/admin/api/2024-04/graphql.json' \
--header 'X-Shopify-Access-Token: XXX' \
--header 'Content-Type: application/json' \
--data '{"query":"mutation flowTriggerReceive($handle: String, $payload: JSON) { \n    flowTriggerReceive(handle: $handle, payload: $payload) \n    { \n        userErrors{\n            message \n            field \n        }\n    }\n}","variables":{"handle":"test-handle","payload":{"order_id":"gid://shopify/Order/1234567890","fulfillmentid":"gid://shopify/Fulfillment/1234567890"}}}'
  • エラーメッセージ
"Errors validating schema:\n  Invalid handle 'test-handle'.\n"

variables内の変数handleには以下の手順を参考に自動生成されたtomlファイルのhandleの値を設定しています。

https://shopify.dev/docs/apps/build/flow/triggers/create

一方、APIバージョンを2023-07に変更し、このバージョンの仕様に合わせてクエリをリクエストを実行すると正常に動作しました。

上記以外に不足している手順もしくはhandleに入れるべき正しい値についてご教示いただけないでしょうか。

よろしくお願いします。

Shopifyのサポートに問い合わせたところ、以下に掲載されている手順およびGraphqlのクエリは使えないようでした。

https://shopify.dev/docs/apps/build/flow/triggers/create

https://shopify.dev/docs/api/admin-graphql/2024-04/mutations/flowTriggerReceive

パートナーダッシュボードからトリガーの拡張機能を作成し、その設定ページにあるGraphqlを使ってリクエストすることで

トリガーが動作しました。また、このGraphqlは最新のAPIバージョン(2024-07)でも有効でした。