--- title: Deep Thrive image: https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/ogimage.png description: カスタムコードアクションで複雑なデータ処理や外部システム連携を実現し、HubSpotワークフローを強化する方法を紹介します。 --- - [**お気に入りした記事](https://member.now-village.jp/favorite) - [**お問い合わせ](https://member.now-village.jp/contact) - [**ログイン](https://member.now-village.jp/_hcms/mem/login?redirect_url=/) ![](https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/icon_dot_button.svg) [DeepThrive. ](https://member.now-village.jp/) - [トップ](https://member.now-village.jp/) - [Data Hub](https://member.now-village.jp/basic/hubspot_data) - カスタムコードアクション # カスタムコードアクション カスタムコードアクションは、ワークフロー内で、JavaScript（Node.js）や一部環境では Python（ベータ）を実行できるアクションです。 Data/Operations Hub Professional または Enterprise で利用可能な「プログラマブルオートメーション」の一部です。 例えば次のようなことができます。 - 複雑なデータ変換・計算（複数プロパティーからスコアを算出など） - 外部APIとの連携（外部システムにデータ送信／取得） - 標準アクションでは難しい条件ロジックの実装 ## 活用目的 - 標準アクションでは足りない複雑なデータ処理をしたいとき - 複数のプロパティーから独自のスコアを計算する - 文字列を細かく分解・結合して独自フォーマットに整形する - 配列・オブジェクトをループ処理して集計値を出す など、HubSpot標準の「レコードを編集」「データを書式設定」だけでは実現しづらい処理を、JavaScript（Node.js）や一部環境でのPython で自由に書けるのがカスタムコードアクションです。 - ワークフローから外部システムやAPIと直接連携したいとき - ワークフロー内のイベントをきっかけに、自社システムのREST APIにデータをPOSTする - 外部サービスから情報を取得して、その内容に応じてHubSpot側のプロパティーや分岐を変える - Webhookトリガーで受け取ったJSONをコードで整形し、別システム向けの形式に変換する - 高度なビジネスロジックや条件分岐を実装したいとき - 「この条件ならAを、別の条件ならBとCを同時に実行」といった複雑なif/elseロジック リストや履歴データをループしながら、「最新の◯件だけを評価する」といった処理 日付・時刻の演算（タイムゾーン・営業日計算など）を細かく制御する ワークフローの標準分岐だけでは表現が難しいロジックを、コード側で完結させて結果だけワークフローに返す用途でよく使われます。 - 受信したWebhookやカスタムイベントデータの「変換・検証」を行いたいとき Webhookトリガーや外部イベントで受信したJSONは、そのままだとプロパティーに格納しづらい場合があります。以下のような、「受信データの整形・検証」を中間処理として行うのに、カスタムコードアクションが適しています。 - 文字列の日付を yyyy-MM-dd やUNIXタイムスタンプに変換してプロパティーに保存する - 受信データをバリデーションし、想定外の値のときはフラグを立てる ## 設定項目 実際のUIでは複数のフィールドがありますが、設計レベルでは 「どのデータを入力に渡すか」→「そのデータで何の処理をするか（コード）」→「結果をどうワークフローに返すか」 の3点をきちんと決めて設定することが、カスタムコードアクションを正しく動かすための必須事項になります。 - 入力データ（インプットデータ） （例）コンタクトのメールアドレス／会社ドメイン／取引金額／直前のアクションの出力など -  実行するコード（ロジック） - 出力データ（アウトプットデータ）の設計 （例）計算結果 - スコア - 正規化した文字列 - 外部APIのレスポンスの一部）を出力　など （例）後続のアクション -「レコードを編集」 - 「データを書式設定」　など ※その出力をプロパティーに保存したり、分岐条件に使ったりする なお、カスタムコードアクションはプレースホルダーにできないため、これらをすべて埋めてからでないとワークフローを有効化できません。 ## 設定方法 1. 画面上部メニューから [自動化] ＞ [ワークフロー] をクリックする 会員登録無料で、 この記事の続きが読めます DeepThrive. 新規無料会員登録のご案内 - 全ての記事を閲覧できます - 会員限定メルマガを受信できます [新規登録](https://member.now-village.jp/register?redirect_url=%2Fbasic%2Fhubspot_data%2Fcustom_code_actions) [ログイン](https://member.now-village.jp/_hcms/mem/login?redirect_url=%2Fbasic%2Fhubspot_data%2Fcustom_code_actions) - [HubSpot 設定](https://member.now-village.jp/basic/hubspot_crm) - [Marketing Hub](https://member.now-village.jp/basic/hubspot_marketing) - [Sales Hub](https://member.now-village.jp/basic/hubspot_sales) - [Service Hub](https://member.now-village.jp/basic/hubspot_service) - [Content Hub](https://member.now-village.jp/basic/hubspot_content) - [Data Hub](https://member.now-village.jp/basic/hubspot_data) - [Commerce Hub](https://member.now-village.jp/basic/hubspot_commerce) - [Breeze・AI](https://member.now-village.jp/basic/hubspot_ai) - [実践・新着情報！](https://member.now-village.jp/deep) [![](https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/banner_cta.png) ](https://lp.now-village.jp/meetings/takayama9/deep-thrive) [HubSpot Basic Knowledge 基本を知る ](https://member.now-village.jp/basic/hubspot_crm) [HubSpot Deep Knowledge 実践・新着情報 ](https://member.now-village.jp/deep) HubSpot knowledge Basic - [基本設定](https://member.now-village.jp/basic/hubspot_crm) - [Marketing Hub](https://member.now-village.jp/basic/hubspot_marketing) - [Sales Hub](https://member.now-village.jp/basic/hubspot_sales) - [Service Hub](https://member.now-village.jp/basic/hubspot_service) - [Content Hub](https://member.now-village.jp/basic/hubspot_content) - [Data Hub](https://member.now-village.jp/basic/hubspot_data) - [Commerce Hub](https://member.now-village.jp/basic/hubspot_commerce) - [Breeze・AI](https://member.now-village.jp/basic/hubspot_ai) [Deep](https://member.now-village.jp/deep) [お気に入りした記事](https://member.now-village.jp/favorite) Service HubSpot - [HubSpot導入支援サービス](https://now-village.jp/service/hubspot-implementation) - [HubSpot運用支援サービス](https://now-village.jp/service/hubspot-operation) - [顧客対応エージェント構築支援サービス](https://now-village.jp/service/hubspot-customer-support-ai-agent) Marketing - [マーケティング支援サービス](https://now-village.jp/service/digital-marketing) - [リスティング広告運用代行](https://now-village.jp/service/listing-advertising) - [コーポレートサイト制作](https://now-village.jp/service/corporate-site) - [コンテンツマーケティング運用代行](https://now-village.jp/service/content-marketing) - [LPOコンサルティング](https://now-village.jp/service/lpo-consulting) - [SNS広告運用代行](https://now-village.jp/service/sns-advertising) - [BtoBサイト制作](https://now-village.jp/service/btob-site) - [SEO記事制作代行](https://now-village.jp/service/seo-article) - [オウンドメディアコンサルティング](https://now-village.jp/service/ownedmedia-consulting) - [オウンドメディア制作](https://now-village.jp/service/ownedmedia) - [メルマガ制作代行](https://now-village.jp/service/mail-magazine) - [ホワイトペーパー制作代行](https://now-village.jp/service/white-paper) - [お問い合わせ](https://member.now-village.jp/contact) - [タグ一覧](https://member.now-village.jp/tag-list) - [お気に入りした記事](https://member.now-village.jp/favorite) - [利用規約](https://member.now-village.jp/terms-of-service) - [プライバシーポリシー](https://member.now-village.jp/privacy-policy) - [運営会社](https://now-village.jp/company) [お問い合わせ](https://member.now-village.jp/contact) [ログイン](https://member.now-village.jp/_hcms/mem/login?redirect_url=/) [![NOWVILLAGE](https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/logo_nowvillage_large.svg) ](https://now-village.jp/) [![Hubspot Platinum SOLUTIONS PARTNER PROGRAM](https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/logo_hubspot_platinum.svg) ](https://member.now-village.jp/basic/hubspot_data/custom_code_actions#) ![](https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/icon_close_drawer.svg) HubSpot - [HubSpot導入支援サービス](https://now-village.jp/service/hubspot-implementation) - [HubSpot運用支援サービス](https://now-village.jp/service/hubspot-operation) - [顧客対応エージェント構築支援サービス](https://now-village.jp/service/hubspot-customer-support-ai-agent) Marketing - [マーケティング支援サービス](https://now-village.jp/service/digital-marketing) - [リスティング広告運用代行](https://now-village.jp/service/listing-advertising) - [コーポレートサイト制作](https://now-village.jp/service/corporate-site) - [コンテンツマーケティング運用代行](https://now-village.jp/service/content-marketing) - [LPOコンサルティング](https://now-village.jp/service/lpo-consulting) - [SNS広告運用代行](https://now-village.jp/service/sns-advertising) - [BtoBサイト制作](https://now-village.jp/service/btob-site) - [SEO記事制作代行](https://now-village.jp/service/seo-article) - [オウンドメディアコンサルティング](https://now-village.jp/service/ownedmedia-consulting) - [オウンドメディア制作](https://now-village.jp/service/ownedmedia) - [メルマガ制作代行](https://now-village.jp/service/mail-magazine) - [ホワイトペーパー制作代行](https://now-village.jp/service/white-paper) - [お問い合わせ](https://member.now-village.jp/contact) - [タグ一覧](https://member.now-village.jp/tag-list) - [お気に入りした記事](https://member.now-village.jp/favorite) - [ログイン](https://member.now-village.jp/_hcms/mem/login?redirect_url=/) - [利用規約](https://member.now-village.jp/terms-of-service) - [プライバシーポリシー](https://member.now-village.jp/privacy-policy) - [運営会社](https://now-village.jp/company) [![NOWVILLAGE](https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/logo_nowvillage.svg) ](https://now-village.jp/) ![Hubspot Platinum SOLUTIONS PARTNER PROGRAM](https://member.now-village.jp/hubfs/raw_assets/public/custom/themes/deepthrive/assets/images/logo_hubspot_platinum.svg) ©NOW VILLAGE Inc. ```json { "@context" : "https://schema.org", "@type" : "BlogPosting", "author" : { "@type" : "Person", "name" : "十亀 奈津美", "url" : "https://member.now-village.jp/basic/hubspot_data/author/十亀-奈津美" }, "dateModified" : "2026-04-14T04:30:49.099Z", "datePublished" : "2026-02-02T04:22:45.000Z", "headline" : "カスタムコードアクション", "mainEntityOfPage" : { "@id" : "https://member.now-village.jp/basic/hubspot_data/custom_code_actions", "@type" : "WebPage" }, "publisher" : { "@type" : "Organization", "logo" : { "@type" : "ImageObject", "url" : "https://member.now-village.jp/hubfs/%E4%BC%9A%E7%A4%BE%E3%83%AD%E3%82%B4(%E8%83%8C%E6%99%AF%E7%84%A1%E3%81%97)-1.png" }, "name" : "ナウビレッジ株式会社" } } ```