HubSpot: マーケティングEメールが取得できない

症状

HubSpot 接続で、取引（Deals）や連絡先（Contacts）は問題なく動くのに、マーケティングEメールの取得・操作だけが失敗する。

エラーにはこのような表記が出ます：

403 MISSING_SCOPES
requiredGranularScopes: ["content"]

原因

マーケティングEメールの API（/marketing/v3/emails）には HubSpot の content スコープが必要です。接続したトークン／OAuth に content が含まれていないと、CRM 系は動いてもマーケティングEメールだけが 403 になります。

marketing.campaigns.read など似た名前のスコープを持っていても、content が無ければ不可です。content は別物です。

対処

接続方式によって直し方が違います。

アクセストークン（Private App）で接続している場合

1. HubSpot の 設定（⚙️）→ 連携 → 非公開アプリ（Private Apps） で、接続に使っている非公開アプリを開く
   • どのアプリのトークンか分からない場合は、アクセストークンが pat-... で始まるアプリを探します
2. スコープタブで content を追加して保存
3. アクセストークンは同じものがそのまま有効（grantry へ貼り直し不要）
4. grantry の接続カードで再チェック

OAuth で接続している場合

1. HubSpot の OAuth アプリ設定で、content を任意（optional）スコープとして追加して保存
2. grantry で HubSpot 接続を OAuth で接続し直す（同意画面で content を許可）
3. 接続カードで再チェック

確認

再チェックでマーケティングEメール系の操作が成功すれば完了です。確認方法は 接続の状態を確認する を参照してください。

複数テナントで使っている場合

テナント（スコープ）ごとに別々のトークン／接続を割り当てている場合、それぞれの接続が使うトークンに content を足す必要があります。1か所直せば全部直る、とは限りません。