Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.
Update an existing reusable Flow Plan’s name, options, AI qualification, or candidate assignees.
Detailed usage guidance
Read get_flow_workspace first to inspect the current settings.
Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list.
Removing candidate assignees can move their affected enrollments to failed.
A name-only or no-op update preserves the current published/draft state.
Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again.
This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts.
Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations.
For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed.
These are shared settings, not per-action or per-enrollment overrides.
The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.
Existing flow plan id. Use the exact flowPlanId returned by create_flow_plan, list_flow_plans, or get_flow_workspace. The MCP Dynamic Actions flowPlanId is permitted only when changing its two allowed HubSpot settings.
flow
object | null
required
Flow settings to update.
Omitted fields keep their current values.
Name-only and no-op updates preserve the current published/draft state; any configuration change pauses a published reusable flow by moving it to Draft.
For the MCP Dynamic Actions Flow Plan, send only mcpDynamicActionsOptions.is_enrich_hubspot and/or mcpDynamicActionsOptions.is_push_to_hubspot_tasks; the task setting updates call, manual, and approval task sync together.
All other fields are rejected.
Show child attributes
returnWorkspace
boolean
default:false
Include a workspace snapshot in the response. Defaults to false. For the MCP Dynamic Actions Flow Plan, this is always null because it does not use a reusable-flow workspace.
Response
Tool result.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"First Touch Documentation","description":"Learn how to configure and use FirstTouch Audiences, Flow Plans, outreach channels, integrations, signals, enrichment, billing, and Team settings.","colors":{"primary":"#3c5d29"},"logo":{"light":"https://mintcdn.com/firsttouchinc/KoeOV6b_CS31YYJH/logo/ft-logo-light.svg?fit=max\u0026auto=format\u0026n=KoeOV6b_CS31YYJH\u0026q=85\u0026s=87af502d498df0381cc422a74010729f","dark":"https://mintcdn.com/firsttouchinc/KoeOV6b_CS31YYJH/logo/ft-logo-dark.svg?fit=max\u0026auto=format\u0026n=KoeOV6b_CS31YYJH\u0026q=85\u0026s=43031200d6e10cf2a9cdd58f9ffa386d","href":"https://firsttouch.com"},"favicon":"https://mintcdn.com/firsttouchinc/YNC84l3c5ycxIlUb/favicon.png?fit=max\u0026auto=format\u0026n=YNC84l3c5ycxIlUb\u0026q=85\u0026s=724d9849b1f153b10ef6deac92b79449","api":{"playground":{}},"icons":{"library":"fontawesome"},"markdown":{"schema":false,"instructions":"For API operations, fetch https://gateway.firsttouch.ai/api/public/openapi.json for the complete input/output schemas, internal references, and x-mcp-annotations. Endpoint Markdown intentionally omits generated schema fragments. Select /api/public/tools/\u003ctool_name> using the exact underscore-separated name. Send requests to https://gateway.firsttouch.ai; the canonical document currently omits servers. Start at https://docs.firsttouch.com/api-reference/agent-start.md."},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"firsttouchinc","hasAudioNarration":false,"actualSubdomain":"firsttouchinc","customDomains":["docs.firsttouch.com"],"gitSource":{"type":"github","owner":"first-touch-inc","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afc86be2ccb0a3576578f8e","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Public API","count":92},{"language":"default","tag":"API Operations","count":86},{"language":"default","tag":"Web App","count":66},{"language":"default","tag":"Flows","count":18},{"language":"default","tag":"Enrollments","count":12},{"language":"default","tag":"Flow Plans","count":11},{"language":"default","tag":"Social Engagement","count":11},{"language":"default","tag":"Contact Data \u0026 Enrichment","count":10},{"language":"default","tag":"Tasks \u0026 Outreach Queues","count":10},{"language":"default","tag":"HubSpot","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/operations/flow-plans/update-flow-plan-settings","slug":"/api-reference/operations/flow-plans/update-flow-plan-settings","pageMetadata":{"title":"Update Flow Plan Settings","description":"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.\n\nUpdate an existing reusable Flow Plan's name, options, AI qualification, or candidate assignees.\n\n\u003cdetails>\n\u003csummary>\u003cstrong>Detailed usage guidance\u003c/strong>\u003c/summary>\n\u003cul>\n\u003cli>Read get_flow_workspace first to inspect the current settings.\u003c/li>\n\u003cli>Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list.\u003c/li>\n\u003cli>Removing candidate assignees can move their affected enrollments to failed.\u003c/li>\n\u003cli>A name-only or no-op update preserves the current published/draft state.\u003c/li>\n\u003cli>Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again.\u003c/li>\n\u003cli>This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts.\u003c/li>\n\u003cli>Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations.\u003c/li>\n\u003cli>For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed.\u003c/li>\n\u003cli>These are shared settings, not per-action or per-enrollment overrides.\u003c/li>\n\u003cli>The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\u003c/li>\n\u003c/ul>\n\u003c/details>","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/update_flow_plan","href":"/api-reference/operations/flow-plans/update-flow-plan-settings","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Update an existing reusable Flow Plan’s name, options, AI qualification, or candidate assignees.\"\n }), \"\\n\", _jsxs(\"details\", {\n children: [_jsx(\"summary\", {\n children: _jsx(\"strong\", {\n children: \"Detailed usage guidance\"\n })\n }), _jsxs(\"ul\", {\n children: [_jsx(\"li\", {\n children: \"Read get_flow_workspace first to inspect the current settings.\"\n }), _jsx(\"li\", {\n children: \"Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list.\"\n }), _jsx(\"li\", {\n children: \"Removing candidate assignees can move their affected enrollments to failed.\"\n }), _jsx(\"li\", {\n children: \"A name-only or no-op update preserves the current published/draft state.\"\n }), _jsx(\"li\", {\n children: \"Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again.\"\n }), _jsx(\"li\", {\n children: \"This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts.\"\n }), _jsx(\"li\", {\n children: \"Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations.\"\n }), _jsx(\"li\", {\n children: \"For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed.\"\n }), _jsx(\"li\", {\n children: \"These are shared settings, not per-action or per-enrollment overrides.\"\n }), _jsx(\"li\", {\n children: \"The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\"\n })]\n })]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update Flow Plan Settings","description":"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.\n\nUpdate an existing reusable Flow Plan's name, options, AI qualification, or candidate assignees.\n\n\u003cdetails>\n\u003csummary>\u003cstrong>Detailed usage guidance\u003c/strong>\u003c/summary>\n\u003cul>\n\u003cli>Read get_flow_workspace first to inspect the current settings.\u003c/li>\n\u003cli>Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list.\u003c/li>\n\u003cli>Removing candidate assignees can move their affected enrollments to failed.\u003c/li>\n\u003cli>A name-only or no-op update preserves the current published/draft state.\u003c/li>\n\u003cli>Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again.\u003c/li>\n\u003cli>This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts.\u003c/li>\n\u003cli>Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations.\u003c/li>\n\u003cli>For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed.\u003c/li>\n\u003cli>These are shared settings, not per-action or per-enrollment overrides.\u003c/li>\n\u003cli>The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\u003c/li>\n\u003c/ul>\n\u003c/details>","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/update_flow_plan","href":"/api-reference/operations/flow-plans/update-flow-plan-settings","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/firsttouchinc/6d1b937a89d41ade/logo/pylon-chat.js"],"openApiReferenceData":{"operation":{"operationId":"update_flow_plan","summary":"Update Flow Plan Settings","description":"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.\n\nUpdate an existing reusable Flow Plan's name, options, AI qualification, or candidate assignees.\n\n\u003cdetails>\n\u003csummary>\u003cstrong>Detailed usage guidance\u003c/strong>\u003c/summary>\n\u003cul>\n\u003cli>Read get_flow_workspace first to inspect the current settings.\u003c/li>\n\u003cli>Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list.\u003c/li>\n\u003cli>Removing candidate assignees can move their affected enrollments to failed.\u003c/li>\n\u003cli>A name-only or no-op update preserves the current published/draft state.\u003c/li>\n\u003cli>Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again.\u003c/li>\n\u003cli>This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts.\u003c/li>\n\u003cli>Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations.\u003c/li>\n\u003cli>For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed.\u003c/li>\n\u003cli>These are shared settings, not per-action or per-enrollment overrides.\u003c/li>\n\u003cli>The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\u003c/li>\n\u003c/ul>\n\u003c/details>","tags":["Flow Plans"],"security":["613bfa83-4452-42c6-87b3-3a7ea622cd8f"],"requestBody":"8028f7b2-0552-4ce4-a550-b5e9980a0980","responses":{"200":"3ef0f411-07dc-48fd-9b14-a6cdfd186dd0","400":"d098dc0f-936e-4ad1-9867-8f3dbfb52844","401":"c39901a2-9c8f-457f-959a-55c6c22e849f","403":"8ccfcfc7-2305-495f-a350-febd1a1ec73b","404":"3e8cb0ee-a3ab-4d9e-9d8e-6b8883a468a7","409":"82de5616-40c2-4650-bd52-a8cdf7c3bdf1","429":"769122c5-efb1-48bc-97b1-259a0117cf94","499":"132f4edb-e254-4673-9a0a-3dfaac16e7e7","500":"d61fe4b9-ba86-4c0e-b1d9-a985b03efc64"},"x-mcp-annotations":{"title":"Update Flow Plan Settings","destructiveHint":true,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":false},"method":"post","type":"path","servers":["242e9488-70ab-42dc-bbbd-3e1d27b9a0d2"],"path":"/api/public/tools/update_flow_plan","baseUrlOptions":["https://gateway.firsttouch.ai"],"title":"Update Flow Plan Settings","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"flowPlanId":{"oneOf":[{"description":"Existing flow plan id. Use the exact flowPlanId returned by create_flow_plan, list_flow_plans, or get_flow_workspace. The MCP Dynamic Actions flowPlanId is permitted only when changing its two allowed HubSpot settings.","type":"string","isRequired":true,"uniqueKey":"flowPlanId.oneOf.0","typeLabel":"string"},{"description":"Existing flow plan id. Use the exact flowPlanId returned by create_flow_plan, list_flow_plans, or get_flow_workspace. The MCP Dynamic Actions flowPlanId is permitted only when changing its two allowed HubSpot settings.","type":"null","isRequired":true,"uniqueKey":"flowPlanId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"flowPlanId","typeLabel":"string | null"},"flow":{"oneOf":[{"description":"Flow settings to update.\n\n- Omitted fields keep their current values.\n- Name-only and no-op updates preserve the current published/draft state; any configuration change pauses a published reusable flow by moving it to Draft.\n- For the MCP Dynamic Actions Flow Plan, send only mcpDynamicActionsOptions.is_enrich_hubspot and/or mcpDynamicActionsOptions.is_push_to_hubspot_tasks; the task setting updates call, manual, and approval task sync together.\n- All other fields are rejected.","type":"object","properties":{"name":{"oneOf":[{"description":"Display name for a regular reusable Flow Plan. Omit to keep the current name. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"string","uniqueKey":"flow.oneOf.0.name.oneOf.0","typeLabel":"string"},{"description":"Display name for a regular reusable Flow Plan. Omit to keep the current name. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"null","uniqueKey":"flow.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.name","typeLabel":"string | null"},"options":{"oneOf":[{"description":"Flow options for a regular reusable Flow Plan. Omit to keep the current options. This is not allowed for the MCP Dynamic Actions Flow Plan; use mcpDynamicActionsOptions instead.","type":"object","properties":{"is_exclusion_check_required":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_exclusion_check_required","typeLabel":"boolean"},"use_hubspot_if_connected":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.use_hubspot_if_connected","typeLabel":"boolean"},"is_click_tracking_enabled":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_click_tracking_enabled","typeLabel":"boolean"},"is_open_tracking_enabled":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_open_tracking_enabled","typeLabel":"boolean"},"is_enrich_phone_if_not_provided":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_enrich_phone_if_not_provided","typeLabel":"boolean"},"push_call_tasks_only_if_phone_exists":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.push_call_tasks_only_if_phone_exists","typeLabel":"boolean"},"ignore_personal_email_accounts":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.ignore_personal_email_accounts","typeLabel":"boolean"},"assignment_strategy":{"type":"string","enum":["default","crm_company_owner","crm_contact_owner"],"isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.assignment_strategy","typeLabel":"enum\u003cstring>"},"crm_on_empty_owner_strategy":{"type":"string","enum":["ignore","process"],"isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.crm_on_empty_owner_strategy","typeLabel":"enum\u003cstring>"},"crm_owner_update_strategy":{"type":"string","enum":["do_not_update","update_company","update_contact","update_company_and_contact"],"isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.crm_owner_update_strategy","typeLabel":"enum\u003cstring>"},"prompt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.prompt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.prompt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.prompt","typeLabel":"string | null"},"is_push_to_hubspot_call_tasks":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_push_to_hubspot_call_tasks","typeLabel":"boolean"},"is_push_to_hubspot_manual_tasks":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_push_to_hubspot_manual_tasks","typeLabel":"boolean"},"is_push_to_hubspot_approve_tasks":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_push_to_hubspot_approve_tasks","typeLabel":"boolean"},"is_enrich_hubspot":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_enrich_hubspot","typeLabel":"boolean"},"is_enrich_prospects":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_enrich_prospects","typeLabel":"boolean"},"is_enrich_companies":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_enrich_companies","typeLabel":"boolean"},"is_enrich_email_if_not_provided":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.is_enrich_email_if_not_provided","typeLabel":"boolean"},"only_enrich_phone_if_call_task_present":{"type":"boolean","default":true,"uniqueKey":"flow.oneOf.0.options.oneOf.0.only_enrich_phone_if_call_task_present","typeLabel":"boolean"},"priority":{"oneOf":[{"type":"integer","default":0,"uniqueKey":"flow.oneOf.0.options.oneOf.0.priority.oneOf.0","typeLabel":"integer"},{"type":"null","default":0,"uniqueKey":"flow.oneOf.0.options.oneOf.0.priority.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.options.oneOf.0.priority","typeLabel":"integer | null"},"require_approval_for_all":{"oneOf":[{"type":"boolean","default":null,"uniqueKey":"flow.oneOf.0.options.oneOf.0.require_approval_for_all.oneOf.0","typeLabel":"boolean"},{"type":"null","default":null,"uniqueKey":"flow.oneOf.0.options.oneOf.0.require_approval_for_all.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.options.oneOf.0.require_approval_for_all","typeLabel":"boolean | null"}},"required":["is_exclusion_check_required","use_hubspot_if_connected","is_click_tracking_enabled","is_open_tracking_enabled","is_enrich_phone_if_not_provided","push_call_tasks_only_if_phone_exists","ignore_personal_email_accounts","assignment_strategy","crm_on_empty_owner_strategy","crm_owner_update_strategy","prompt","is_push_to_hubspot_call_tasks","is_push_to_hubspot_manual_tasks","is_push_to_hubspot_approve_tasks","is_enrich_hubspot","is_enrich_prospects","is_enrich_companies","is_enrich_email_if_not_provided"],"uniqueKey":"flow.oneOf.0.options.oneOf.0","typeLabel":"object"},{"description":"Flow options for a regular reusable Flow Plan. Omit to keep the current options. This is not allowed for the MCP Dynamic Actions Flow Plan; use mcpDynamicActionsOptions instead.","type":"null","properties":{"is_exclusion_check_required":{"type":"boolean"},"use_hubspot_if_connected":{"type":"boolean"},"is_click_tracking_enabled":{"type":"boolean"},"is_open_tracking_enabled":{"type":"boolean"},"is_enrich_phone_if_not_provided":{"type":"boolean"},"push_call_tasks_only_if_phone_exists":{"type":"boolean"},"ignore_personal_email_accounts":{"type":"boolean"},"assignment_strategy":{"type":"string","enum":["default","crm_company_owner","crm_contact_owner"]},"crm_on_empty_owner_strategy":{"type":"string","enum":["ignore","process"]},"crm_owner_update_strategy":{"type":"string","enum":["do_not_update","update_company","update_contact","update_company_and_contact"]},"prompt":{"oneOf":[{"type":"string"},{"type":"null"}]},"is_push_to_hubspot_call_tasks":{"type":"boolean"},"is_push_to_hubspot_manual_tasks":{"type":"boolean"},"is_push_to_hubspot_approve_tasks":{"type":"boolean"},"is_enrich_hubspot":{"type":"boolean"},"is_enrich_prospects":{"type":"boolean"},"is_enrich_companies":{"type":"boolean"},"is_enrich_email_if_not_provided":{"type":"boolean"},"only_enrich_phone_if_call_task_present":{"type":"boolean","default":true},"priority":{"oneOf":[{"type":"integer","default":0},{"type":"null","default":0}]},"require_approval_for_all":{"oneOf":[{"type":"boolean","default":null},{"type":"null","default":null}]}},"required":["is_exclusion_check_required","use_hubspot_if_connected","is_click_tracking_enabled","is_open_tracking_enabled","is_enrich_phone_if_not_provided","push_call_tasks_only_if_phone_exists","ignore_personal_email_accounts","assignment_strategy","crm_on_empty_owner_strategy","crm_owner_update_strategy","prompt","is_push_to_hubspot_call_tasks","is_push_to_hubspot_manual_tasks","is_push_to_hubspot_approve_tasks","is_enrich_hubspot","is_enrich_prospects","is_enrich_companies","is_enrich_email_if_not_provided"],"uniqueKey":"flow.oneOf.0.options.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.options","typeLabel":"object | null"},"mcpDynamicActionsOptions":{"oneOf":[{"description":"Shared HubSpot settings for the MCP Dynamic Actions Flow Plan.\n\n- Only is_enrich_hubspot and is_push_to_hubspot_tasks are allowed.\n- is_push_to_hubspot_tasks updates call, manual, and approval task sync together.\n- Do not use this for regular reusable Flow Plans.","type":"object","properties":{"is_enrich_hubspot":{"oneOf":[{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"boolean","uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.0.is_enrich_hubspot.oneOf.0","typeLabel":"boolean"},{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"null","uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.0.is_enrich_hubspot.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.0.is_enrich_hubspot","typeLabel":"boolean | null"},"is_push_to_hubspot_tasks":{"oneOf":[{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"boolean","uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.0.is_push_to_hubspot_tasks.oneOf.0","typeLabel":"boolean"},{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"null","uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.0.is_push_to_hubspot_tasks.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.0.is_push_to_hubspot_tasks","typeLabel":"boolean | null"}},"uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.0","typeLabel":"object"},{"description":"Shared HubSpot settings for the MCP Dynamic Actions Flow Plan.\n\n- Only is_enrich_hubspot and is_push_to_hubspot_tasks are allowed.\n- is_push_to_hubspot_tasks updates call, manual, and approval task sync together.\n- Do not use this for regular reusable Flow Plans.","type":"null","properties":{"is_enrich_hubspot":{"oneOf":[{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"boolean"},{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"null"}]},"is_push_to_hubspot_tasks":{"oneOf":[{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"boolean"},{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"null"}]}},"uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.mcpDynamicActionsOptions","typeLabel":"object | null"},"aiQualification":{"oneOf":[{"description":"Flow-level AI qualification settings for reusable flows. Omit to keep the current AI qualification settings. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"object","properties":{"is_enabled":{"type":"boolean","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.is_enabled","typeLabel":"boolean"},"threshold":{"type":"integer","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.threshold","typeLabel":"integer"},"prospect_criteria":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.prospect_criteria.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.prospect_criteria.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.prospect_criteria","typeLabel":"string | null"},"company_criteria":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.company_criteria.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.company_criteria.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.company_criteria","typeLabel":"string | null"},"disqualify_criteria":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.disqualify_criteria.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.disqualify_criteria.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0.disqualify_criteria","typeLabel":"string | null"}},"required":["is_enabled","threshold","prospect_criteria","company_criteria","disqualify_criteria"],"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.0","typeLabel":"object"},{"description":"Flow-level AI qualification settings for reusable flows. Omit to keep the current AI qualification settings. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"null","properties":{"is_enabled":{"type":"boolean"},"threshold":{"type":"integer"},"prospect_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]},"company_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]},"disqualify_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["is_enabled","threshold","prospect_criteria","company_criteria","disqualify_criteria"],"uniqueKey":"flow.oneOf.0.aiQualification.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.aiQualification","typeLabel":"object | null"},"candidates":{"oneOf":[{"description":"Candidate assignees for reusable flows. Omit to keep current candidates. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"array","items":{"oneOf":[{"type":"object","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string","isRequired":true,"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.userId.oneOf.0","typeLabel":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null","isRequired":true,"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.userId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.userId","typeLabel":"string | null"},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.emailAccountIds.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.emailAccountIds.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.emailAccountIds.oneOf.0.items.[INDEX]","typeLabel":"string | null"},"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.emailAccountIds.oneOf.0","typeLabel":"(string | null)[]"},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]},"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.emailAccountIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0.emailAccountIds","typeLabel":"(string | null)[] | null"}},"required":["userId"],"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null"}]},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string"},{"type":"null"}]}},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]}}]}},"required":["userId"],"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.candidates.oneOf.0.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"flow.oneOf.0.candidates.oneOf.0","typeLabel":"(object | null)[]"},{"description":"Candidate assignees for reusable flows. Omit to keep current candidates. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"null","items":{"oneOf":[{"type":"object","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null"}]},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string"},{"type":"null"}]}},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]}}]}},"required":["userId"]},{"type":"null","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null"}]},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string"},{"type":"null"}]}},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]}}]}},"required":["userId"]}]},"uniqueKey":"flow.oneOf.0.candidates.oneOf.1","typeLabel":"null"}],"uniqueKey":"flow.oneOf.0.candidates","typeLabel":"(object | null)[] | null"}},"isRequired":true,"uniqueKey":"flow.oneOf.0","typeLabel":"object"},{"description":"Flow settings to update.\n\n- Omitted fields keep their current values.\n- Name-only and no-op updates preserve the current published/draft state; any configuration change pauses a published reusable flow by moving it to Draft.\n- For the MCP Dynamic Actions Flow Plan, send only mcpDynamicActionsOptions.is_enrich_hubspot and/or mcpDynamicActionsOptions.is_push_to_hubspot_tasks; the task setting updates call, manual, and approval task sync together.\n- All other fields are rejected.","type":"null","properties":{"name":{"oneOf":[{"description":"Display name for a regular reusable Flow Plan. Omit to keep the current name. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"string"},{"description":"Display name for a regular reusable Flow Plan. Omit to keep the current name. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"null"}]},"options":{"oneOf":[{"description":"Flow options for a regular reusable Flow Plan. Omit to keep the current options. This is not allowed for the MCP Dynamic Actions Flow Plan; use mcpDynamicActionsOptions instead.","type":"object","properties":{"is_exclusion_check_required":{"type":"boolean"},"use_hubspot_if_connected":{"type":"boolean"},"is_click_tracking_enabled":{"type":"boolean"},"is_open_tracking_enabled":{"type":"boolean"},"is_enrich_phone_if_not_provided":{"type":"boolean"},"push_call_tasks_only_if_phone_exists":{"type":"boolean"},"ignore_personal_email_accounts":{"type":"boolean"},"assignment_strategy":{"type":"string","enum":["default","crm_company_owner","crm_contact_owner"]},"crm_on_empty_owner_strategy":{"type":"string","enum":["ignore","process"]},"crm_owner_update_strategy":{"type":"string","enum":["do_not_update","update_company","update_contact","update_company_and_contact"]},"prompt":{"oneOf":[{"type":"string"},{"type":"null"}]},"is_push_to_hubspot_call_tasks":{"type":"boolean"},"is_push_to_hubspot_manual_tasks":{"type":"boolean"},"is_push_to_hubspot_approve_tasks":{"type":"boolean"},"is_enrich_hubspot":{"type":"boolean"},"is_enrich_prospects":{"type":"boolean"},"is_enrich_companies":{"type":"boolean"},"is_enrich_email_if_not_provided":{"type":"boolean"},"only_enrich_phone_if_call_task_present":{"type":"boolean","default":true},"priority":{"oneOf":[{"type":"integer","default":0},{"type":"null","default":0}]},"require_approval_for_all":{"oneOf":[{"type":"boolean","default":null},{"type":"null","default":null}]}},"required":["is_exclusion_check_required","use_hubspot_if_connected","is_click_tracking_enabled","is_open_tracking_enabled","is_enrich_phone_if_not_provided","push_call_tasks_only_if_phone_exists","ignore_personal_email_accounts","assignment_strategy","crm_on_empty_owner_strategy","crm_owner_update_strategy","prompt","is_push_to_hubspot_call_tasks","is_push_to_hubspot_manual_tasks","is_push_to_hubspot_approve_tasks","is_enrich_hubspot","is_enrich_prospects","is_enrich_companies","is_enrich_email_if_not_provided"]},{"description":"Flow options for a regular reusable Flow Plan. Omit to keep the current options. This is not allowed for the MCP Dynamic Actions Flow Plan; use mcpDynamicActionsOptions instead.","type":"null","properties":{"is_exclusion_check_required":{"type":"boolean"},"use_hubspot_if_connected":{"type":"boolean"},"is_click_tracking_enabled":{"type":"boolean"},"is_open_tracking_enabled":{"type":"boolean"},"is_enrich_phone_if_not_provided":{"type":"boolean"},"push_call_tasks_only_if_phone_exists":{"type":"boolean"},"ignore_personal_email_accounts":{"type":"boolean"},"assignment_strategy":{"type":"string","enum":["default","crm_company_owner","crm_contact_owner"]},"crm_on_empty_owner_strategy":{"type":"string","enum":["ignore","process"]},"crm_owner_update_strategy":{"type":"string","enum":["do_not_update","update_company","update_contact","update_company_and_contact"]},"prompt":{"oneOf":[{"type":"string"},{"type":"null"}]},"is_push_to_hubspot_call_tasks":{"type":"boolean"},"is_push_to_hubspot_manual_tasks":{"type":"boolean"},"is_push_to_hubspot_approve_tasks":{"type":"boolean"},"is_enrich_hubspot":{"type":"boolean"},"is_enrich_prospects":{"type":"boolean"},"is_enrich_companies":{"type":"boolean"},"is_enrich_email_if_not_provided":{"type":"boolean"},"only_enrich_phone_if_call_task_present":{"type":"boolean","default":true},"priority":{"oneOf":[{"type":"integer","default":0},{"type":"null","default":0}]},"require_approval_for_all":{"oneOf":[{"type":"boolean","default":null},{"type":"null","default":null}]}},"required":["is_exclusion_check_required","use_hubspot_if_connected","is_click_tracking_enabled","is_open_tracking_enabled","is_enrich_phone_if_not_provided","push_call_tasks_only_if_phone_exists","ignore_personal_email_accounts","assignment_strategy","crm_on_empty_owner_strategy","crm_owner_update_strategy","prompt","is_push_to_hubspot_call_tasks","is_push_to_hubspot_manual_tasks","is_push_to_hubspot_approve_tasks","is_enrich_hubspot","is_enrich_prospects","is_enrich_companies","is_enrich_email_if_not_provided"]}]},"mcpDynamicActionsOptions":{"oneOf":[{"description":"Shared HubSpot settings for the MCP Dynamic Actions Flow Plan.\n\n- Only is_enrich_hubspot and is_push_to_hubspot_tasks are allowed.\n- is_push_to_hubspot_tasks updates call, manual, and approval task sync together.\n- Do not use this for regular reusable Flow Plans.","type":"object","properties":{"is_enrich_hubspot":{"oneOf":[{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"boolean"},{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"null"}]},"is_push_to_hubspot_tasks":{"oneOf":[{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"boolean"},{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"null"}]}}},{"description":"Shared HubSpot settings for the MCP Dynamic Actions Flow Plan.\n\n- Only is_enrich_hubspot and is_push_to_hubspot_tasks are allowed.\n- is_push_to_hubspot_tasks updates call, manual, and approval task sync together.\n- Do not use this for regular reusable Flow Plans.","type":"null","properties":{"is_enrich_hubspot":{"oneOf":[{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"boolean"},{"description":"Whether HubSpot contact and company records are enriched for Dynamic Actions. Defaults to the current setting when omitted.","type":"null"}]},"is_push_to_hubspot_tasks":{"oneOf":[{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"boolean"},{"description":"Whether call, manual, and approval tasks from Dynamic Actions are created in HubSpot together. Defaults to the current setting when omitted.","type":"null"}]}}}]},"aiQualification":{"oneOf":[{"description":"Flow-level AI qualification settings for reusable flows. Omit to keep the current AI qualification settings. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"object","properties":{"is_enabled":{"type":"boolean"},"threshold":{"type":"integer"},"prospect_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]},"company_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]},"disqualify_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["is_enabled","threshold","prospect_criteria","company_criteria","disqualify_criteria"]},{"description":"Flow-level AI qualification settings for reusable flows. Omit to keep the current AI qualification settings. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"null","properties":{"is_enabled":{"type":"boolean"},"threshold":{"type":"integer"},"prospect_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]},"company_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]},"disqualify_criteria":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["is_enabled","threshold","prospect_criteria","company_criteria","disqualify_criteria"]}]},"candidates":{"oneOf":[{"description":"Candidate assignees for reusable flows. Omit to keep current candidates. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"array","items":{"oneOf":[{"type":"object","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null"}]},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string"},{"type":"null"}]}},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]}}]}},"required":["userId"]},{"type":"null","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null"}]},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string"},{"type":"null"}]}},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]}}]}},"required":["userId"]}]}},{"description":"Candidate assignees for reusable flows. Omit to keep current candidates. This is not allowed for the MCP Dynamic Actions Flow Plan.","type":"null","items":{"oneOf":[{"type":"object","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null"}]},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string"},{"type":"null"}]}},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]}}]}},"required":["userId"]},{"type":"null","properties":{"userId":{"oneOf":[{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"string"},{"description":"Team member user id. Use the exact userId returned by list_team_members.","type":"null"}]},"emailAccountIds":{"oneOf":[{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"array","items":{"oneOf":[{"type":"string"},{"type":"null"}]}},{"description":"Optional email account ids for the candidate. Example item: email_account_123. Use emailAccounts returned by list_team_members. Empty means all active inboxes for this candidate; non-empty means only the listed inboxes.","type":"null","items":{"oneOf":[{"type":"string"},{"type":"null"}]}}]}},"required":["userId"]}]}}]}},"isRequired":true,"uniqueKey":"flow.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"flow","typeLabel":"object | null"},"returnWorkspace":{"description":"Include a workspace snapshot in the response. Defaults to false. For the MCP Dynamic Actions Flow Plan, this is always null because it does not use a reusable-flow workspace.","type":"boolean","default":false,"uniqueKey":"returnWorkspace","typeLabel":"boolean"}},"required":["flowPlanId","flow"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"flowPlanId":"\u003cstring>","flow":{"name":"\u003cstring>","options":{"is_exclusion_check_required":true,"use_hubspot_if_connected":true,"is_click_tracking_enabled":true,"is_open_tracking_enabled":true,"is_enrich_phone_if_not_provided":true,"push_call_tasks_only_if_phone_exists":true,"ignore_personal_email_accounts":true,"prompt":"\u003cstring>","is_push_to_hubspot_call_tasks":true,"is_push_to_hubspot_manual_tasks":true,"is_push_to_hubspot_approve_tasks":true,"is_enrich_hubspot":true,"is_enrich_prospects":true,"is_enrich_companies":true,"is_enrich_email_if_not_provided":true,"only_enrich_phone_if_call_task_present":true,"priority":0,"require_approval_for_all":null},"mcpDynamicActionsOptions":{"is_enrich_hubspot":true,"is_push_to_hubspot_tasks":true},"aiQualification":{"is_enabled":true,"threshold":123,"prospect_criteria":"\u003cstring>","company_criteria":"\u003cstring>","disqualify_criteria":"\u003cstring>"},"candidates":[{"userId":"\u003cstring>","emailAccountIds":["\u003cstring>"]}]},"returnWorkspace":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3ef0f411-07dc-48fd-9b14-a6cdfd186dd0":{"description":"Tool result.","content":{"application/json":{"schema":{}}},"exampleType":"generated"},"d098dc0f-936e-4ad1-9867-8f3dbfb52844":{"description":"Malformed tool input or validation failure.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c39901a2-9c8f-457f-959a-55c6c22e849f":{"description":"Authentication failed.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8ccfcfc7-2305-495f-a350-febd1a1ec73b":{"description":"The caller cannot perform this operation.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3e8cb0ee-a3ab-4d9e-9d8e-6b8883a468a7":{"description":"The requested resource was not found.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"},"82de5616-40c2-4650-bd52-a8cdf7c3bdf1":{"description":"The operation conflicts with current state.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"},"769122c5-efb1-48bc-97b1-259a0117cf94":{"description":"The operation was rate limited.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"},"132f4edb-e254-4673-9a0a-3dfaac16e7e7":{"description":"The client canceled the request.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d61fe4b9-ba86-4c0e-b1d9-a985b03efc64":{"description":"Unexpected tool failure.","content":{"application/json":{"schema":{"type":"object","required":["error","message","traceId"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"details":{"type":"object","properties":{"currentStatus":{"type":"string","enum":["pending","failed","canceled"],"uniqueKey":"details.currentStatus","typeLabel":"enum\u003cstring>"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","traceId":"\u003cstring>","details":{"currentStatus":"pending"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"613bfa83-4452-42c6-87b3-3a7ea622cd8f":{"X-API-Key":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"X-API-Key"}}},"servers":{"242e9488-70ab-42dc-bbbd-3e1d27b9a0d2":{"url":"https://gateway.firsttouch.ai","description":"FirstTouch production Public API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"X-API-Key"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"X-API-Key","name":"X-API-Key"}],"title":"X-API-Key"}]},"originalFileLocation":"https://gateway.firsttouch.ai/api/public/openapi.json"},"subdomain":"firsttouchinc","siteName":"First Touch Documentation","title":"Update Flow Plan Settings - First Touch Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T16:54:09.729Z","originalFileLocation":"api-reference/operations/flow-plans/update-flow-plan-settings.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Update an existing reusable Flow Plan\u0026#x27;s name, options, AI qualification, or candidate assignees. Detailed usage guidance Read get_flow_workspace first to inspect the current settings. Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list. Removing candidate assignees can move their affected enrollments to failed. A name-only or no-op update preserves the current published/draft state. Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again. This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts. Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations. For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed. These are shared settings, not per-action or per-enrollment overrides. The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\">\u003cmeta data-mint-head name=\"application-name\" content=\"First Touch Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Flow Plan Settings - First Touch Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Update an existing reusable Flow Plan\u0026#x27;s name, options, AI qualification, or candidate assignees. Detailed usage guidance Read get_flow_workspace first to inspect the current settings. Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list. Removing candidate assignees can move their affected enrollments to failed. A name-only or no-op update preserves the current published/draft state. Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again. This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts. Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations. For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed. These are shared settings, not per-action or per-enrollment overrides. The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"First Touch Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://firsttouchinc.mintlify.site/_mintlify/api/og/v2?division=Flow+Plans\u0026amp;title=Update+Flow+Plan+Settings\u0026amp;description=Requires+the+admin+team+role+or+global+admin+access.+Check+get_current_user.toolAccess+before+calling.%0A%0AUpdate+an+existing+reusable+Flow+Plan%27s+name%2C+options%2C+A\u0026amp;theme=5f85d7151b19d4015bee1fbc\u0026amp;signature=1edc2c6d4c6205c46b3d0aa09d1a5babdd9a9a71a9084a7d7f70a6de2f21f23f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update Flow Plan Settings - First Touch Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Update an existing reusable Flow Plan\u0026#x27;s name, options, AI qualification, or candidate assignees. Detailed usage guidance Read get_flow_workspace first to inspect the current settings. Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list. Removing candidate assignees can move their affected enrollments to failed. A name-only or no-op update preserves the current published/draft state. Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again. This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts. Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations. For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed. These are shared settings, not per-action or per-enrollment overrides. The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://firsttouchinc.mintlify.site/_mintlify/api/og/v2?division=Flow+Plans\u0026amp;title=Update+Flow+Plan+Settings\u0026amp;description=Requires+the+admin+team+role+or+global+admin+access.+Check+get_current_user.toolAccess+before+calling.%0A%0AUpdate+an+existing+reusable+Flow+Plan%27s+name%2C+options%2C+A\u0026amp;theme=5f85d7151b19d4015bee1fbc\u0026amp;signature=1edc2c6d4c6205c46b3d0aa09d1a5babdd9a9a71a9084a7d7f70a6de2f21f23f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/firsttouchinc/U9nO7K0uTyb4nKbc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"First Touch Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3c5d29\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/operations/flow-plans/update-flow-plan-settings.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.firsttouch.com/#organization\",\"name\":\"First Touch Documentation\",\"url\":\"https://docs.firsttouch.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/firsttouchinc/KoeOV6b_CS31YYJH/logo/ft-logo-light.svg?fit=max\u0026auto=format\u0026n=KoeOV6b_CS31YYJH\u0026q=85\u0026s=87af502d498df0381cc422a74010729f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.firsttouch.com#website\",\"name\":\"First Touch Documentation\",\"url\":\"https://docs.firsttouch.com\",\"publisher\":{\"@id\":\"https://docs.firsttouch.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings#webpage\",\"url\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings\",\"name\":\"Update Flow Plan Settings\",\"description\":\"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Update an existing reusable Flow Plan's name, options, AI qualification, or candidate assignees. Detailed usage guidance Read get_flow_workspace first to inspect the current settings. Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list. Removing candidate assignees can move their affected enrollments to failed. A name-only or no-op update preserves the current published/draft state. Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again. This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts. Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations. For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed. These are shared settings, not per-action or per-enrollment overrides. The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\",\"dateModified\":\"2026-11-17T16:54:09.729Z\",\"isPartOf\":{\"@id\":\"https://docs.firsttouch.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Public API\",\"item\":\"https://docs.firsttouch.com/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Operations\",\"item\":\"https://docs.firsttouch.com/api-reference/operations\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Flow Plans\",\"item\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/create-draft-flow-plan\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Update Flow Plan Settings\",\"item\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings#apireference\",\"headline\":\"Update Flow Plan Settings\",\"name\":\"Update Flow Plan Settings\",\"description\":\"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Update an existing reusable Flow Plan's name, options, AI qualification, or candidate assignees. Detailed usage guidance Read get_flow_workspace first to inspect the current settings. Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list. Removing candidate assignees can move their affected enrollments to failed. A name-only or no-op update preserves the current published/draft state. Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again. This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts. Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations. For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed. These are shared settings, not per-action or per-enrollment overrides. The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.\",\"url\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings\",\"mainEntityOfPage\":{\"@id\":\"https://docs.firsttouch.com/api-reference/operations/flow-plans/update-flow-plan-settings#webpage\"},\"dateModified\":\"2026-11-17T16:54:09.729Z\",\"publisher\":{\"@id\":\"https://docs.firsttouch.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.firsttouch.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"First Touch Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"First Touch Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/operations/flow-plans/update-flow-plan-settings.md","siteName":"First Touch Documentation","nav":{"global":null,"groups":[{"group":"Start Here","pages":[{"title":"First Touch","href":"/index"},{"title":"Getting Started","sidebarTitle":"Quick Start","icon":"rocket-launch","mode":"wide","href":"/getting-started/overview"},{"title":"Setup","href":"/getting-started/setup/setup"},{"title":"Account Access","icon":"key","href":"/WebApp/Account-Access"}]},{"group":"Web App","pages":[{"title":"Web App Overview","icon":"laptop","href":"/WebApp/overview"},{"title":"Dashboard and Analytics","icon":"chart-line","href":"/WebApp/Dashboard-and-Analytics"},{"title":"Onboarding Agent","icon":"robot","href":"/WebApp/Onboarding-Agent"},{"title":"Billing, Plans, and Credits","icon":"credit-card","href":"/WebApp/Billing"},{"title":"Team Management","icon":"users-gear","href":"/WebApp/Team-Management"},{"title":"Roles, Seat Types, and Permissions","icon":"shield-user","href":"/WebApp/Roles-and-Permissions"},{"title":"Tasks","icon":"list-check","href":"/WebApp/Tasks"},{"title":"Activities","icon":"clock-rotate-left","href":"/WebApp/Activities"},{"title":"Outreach Queue","icon":"rectangle-list","href":"/WebApp/Outreach-Queue"},{"group":"Flows","pages":[{"title":"Create and Edit Flows","icon":"pen-ruler","href":"/WebApp/Flows/creating-and-editing"},{"title":"First Flow Guide","icon":"diagram-project","href":"/WebApp/Flows/first-flow-guide"},{"title":"Choose a Source","icon":"bolt","href":"/WebApp/Flows/choosing-a-trigger"},{"title":"Flow Settings","icon":"gear","href":"/WebApp/Flows/flow-settings"},{"title":"Messaging Guide","icon":"message-pen","href":"/WebApp/Flows/Master-Messaging-Guide"},{"title":"Variables and Personalization","icon":"brackets-curly","href":"/WebApp/Flows/variables-and-personalization"},{"title":"Personalize LinkedIn Connection Notes","sidebarTitle":"Personalized Connection Notes","icon":"user-plus","href":"/WebApp/Flows/personalized-linkedin-connection-notes"},{"title":"Flow Enrollments","icon":"route","href":"/WebApp/Flows/enrollments"},{"group":"Available Flow Actions","pages":[{"title":"Email Steps","icon":"envelope","href":"/WebApp/Flows/Available-Flow-Actions/Email-Steps"},{"title":"Action Delays","icon":"hourglass","href":"/WebApp/Flows/Available-Flow-Actions/Delays"},{"title":"Conditional Split","icon":"code-branch","href":"/WebApp/Flows/Available-Flow-Actions/Conditional-Split"},{"title":"Manual Tasks","icon":"list-check","href":"/WebApp/Flows/Available-Flow-Actions/Manual-Tasks"},{"title":"Manual Assignment","icon":"user-pen","href":"/WebApp/Flows/Available-Flow-Actions/Manual-Assignment"},{"title":"CRM Enrichment","icon":"database","href":"/WebApp/Flows/Available-Flow-Actions/CRM-Enrichment"}]},{"group":"Agents","pages":[{"title":"Agents Overview","icon":"robot","href":"/WebApp/Flows/Agents/overview"},{"title":"Research Agent","icon":"globe","href":"/WebApp/Flows/Agents/researcher"},{"title":"Qualification Agent","icon":"filter-list","href":"/WebApp/Flows/Agents/qualification"}]},{"title":"Publish and Route Flows","icon":"paper-plane","href":"/WebApp/Flows/publishing"}]},{"group":"Signals","pages":[{"title":"Signals","icon":"tower-broadcast","href":"/WebApp/Signals/Overview"},{"title":"Website Visitors","icon":"globe-pointer","href":"/WebApp/Signals/Website-Visitors"},{"title":"Social Engagement","icon":"linkedin","iconType":"brands","href":"/WebApp/Signals/Social-Engagement"}]},{"title":"Audiences","sidebarTitle":"Audiences","icon":"users","href":"/WebApp/Audiences"},{"title":"Exclusion Lists","icon":"ban","href":"/WebApp/Exclusion-Lists"},{"group":"Email","pages":[{"title":"Email Automation","icon":"envelope","href":"/WebApp/Email/Overview"},{"title":"Email Sending and Scheduling","icon":"calendar-clock","href":"/WebApp/Email/Sending-and-Scheduling"},{"title":"Email Tracking, Replies, and Bounces","icon":"reply-all","href":"/WebApp/Email/Tracking-and-Replies"},{"title":"Email Troubleshooting","icon":"triangle-exclamation","href":"/WebApp/Email/Troubleshooting"}]},{"group":"Data Enrichment","pages":[{"title":"Data Enrichment","icon":"sparkles","href":"/WebApp/Data-Enrichment/Overview"},{"title":"Data Enrichment Troubleshooting","icon":"magnifying-glass-question","href":"/WebApp/Data-Enrichment/Troubleshooting"}]},{"title":"Sales Navigator Import","icon":"linkedin","iconType":"brands","href":"/WebApp/Sales-Navigator-Import"},{"group":"FirstTouch MCP","pages":[{"title":"Overview","sidebarTitle":"Overview","icon":"sparkles","href":"/WebApp/Mcp/overview"},{"title":"Connect FirstTouch MCP","sidebarTitle":"Connect","icon":"plug","href":"/WebApp/Mcp/connect"},{"title":"FirstTouch MCP Use Cases","sidebarTitle":"Use Cases","icon":"diagram-project","href":"/WebApp/Mcp/use-cases"},{"title":"FirstTouch MCP Prompt Library","sidebarTitle":"Prompt Library","icon":"message-lines","href":"/WebApp/Mcp/prompt-library"},{"title":"FirstTouch MCP Troubleshooting","sidebarTitle":"Troubleshooting","icon":"circle-question","href":"/WebApp/Mcp/troubleshooting"}]},{"group":"Slack","pages":[{"title":"Slack Agent","icon":"comments","href":"/WebApp/Slack/Agent"},{"title":"Slack Task Notifications","icon":"bell","href":"/WebApp/Slack/Task-Notifications"}]},{"group":"Social Platforms","pages":[{"title":"Social Integration","icon":"arrow-right-to-bracket","href":"/WebApp/Social/social-Integration"},{"title":"LinkedIn Actions","icon":"arrow-progress","href":"/WebApp/Social/Social-Orchestration"},{"title":"LinkedIn Unibox","icon":"inbox","href":"/WebApp/Social/LinkedIn-Unibox"}]},{"group":"HubSpot","pages":[{"title":"HubSpot Setup Guide","icon":"hubspot","iconType":"brands","href":"/WebApp/HubSpot/HubSpot-Quickstart-Guide"},{"title":"FirstTouch HubSpot Card","icon":"id-card","href":"/WebApp/HubSpot/UI-Card"},{"title":"Workflow Actions","icon":"diagram-project","href":"/WebApp/HubSpot/Workflow-Actions"},{"title":"HubSpot Task and Activity Sync","icon":"arrows-rotate","href":"/WebApp/HubSpot/Task-and-Activity-Sync"},{"title":"HubSpot Property Mapping","icon":"table-columns","href":"/WebApp/HubSpot/Property-Mapping"},{"title":"HubSpot Troubleshooting","icon":"wrench","href":"/WebApp/HubSpot/Troubleshooting"}]},{"group":"Settings","pages":[{"title":"User Settings","icon":"user-gear","href":"/WebApp/Settings/profile"},{"title":"User Accounts","icon":"circle-user","href":"/WebApp/Settings/user-accounts"},{"title":"Find your LinkedIn 2FA key","icon":"key","href":"/WebApp/Settings/linkedin-2fa-key"},{"title":"Sending Schedule","icon":"calendar-clock","href":"/WebApp/Settings/sending-schedule"},{"title":"Knowledge Base","icon":"brain","href":"/WebApp/Settings/knowledge-base"},{"title":"Security","icon":"lock","href":"/WebApp/Settings/security"},{"title":"Public API Keys","icon":"key","href":"/WebApp/Settings/api-keys"}]},{"group":"Team Settings","pages":[{"title":"HubSpot Integration","icon":"plug","href":"/WebApp/Settings/integrations"},{"group":"Webhooks","pages":[{"title":"Configure Webhooks","icon":"webhook","href":"/WebApp/Webhooks/overview"},{"title":"Webhook Technical Reference","icon":"code","href":"/WebApp/Webhooks/technical-reference"},{"title":"Webhook Troubleshooting","icon":"triangle-exclamation","href":"/WebApp/Webhooks/troubleshooting"}]}]}]},{"group":"Public API","pages":[{"title":"Public API Overview","sidebarTitle":"Overview","icon":"brackets-curly","href":"/api-reference/introduction"},{"title":"Agent Start Here","icon":"robot","href":"/api-reference/agent-start"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Quickstart","icon":"rocket","href":"/api-reference/quickstart"},{"title":"Execution And Recovery","icon":"rotate","href":"/api-reference/execution-and-recovery"},{"title":"Check your setup before LinkedIn outreach","icon":"clipboard-check","href":"/api-reference/recipes/approved-linkedin-outreach"},{"group":"API Operations","root":{"title":"API Operations","icon":"book-open","href":"/api-reference/operations"},"pages":[{"group":"Social Engagement","pages":[{"title":"Activate Social Engagement Monitored Profile","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/activate_social_engagement_monitored_profile","href":"/api-reference/operations/social-engagement/activate-social-engagement-monitored-profile"},{"title":"Add Social Engagement Monitored Profile","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/add_social_engagement_monitored_profile","href":"/api-reference/operations/social-engagement/add-social-engagement-monitored-profile"},{"title":"Create Social Engagement Signal","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/create_social_engagement_signal","href":"/api-reference/operations/social-engagement/create-social-engagement-signal"},{"title":"Deactivate Social Engagement Monitored Profile","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/deactivate_social_engagement_monitored_profile","href":"/api-reference/operations/social-engagement/deactivate-social-engagement-monitored-profile"},{"title":"Delete Social Engagement Monitored Profile","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/delete_social_engagement_monitored_profile","href":"/api-reference/operations/social-engagement/delete-social-engagement-monitored-profile"},{"title":"Get Social Engagement Signal","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_social_engagement_signal","href":"/api-reference/operations/social-engagement/get-social-engagement-signal"},{"title":"List Social Engagement Engagers","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_social_engagement_engagers","href":"/api-reference/operations/social-engagement/list-social-engagement-engagers"},{"title":"List Social Engagement Monitored Profiles","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_social_engagement_monitored_profiles","href":"/api-reference/operations/social-engagement/list-social-engagement-monitored-profiles"},{"title":"List Social Engagement Signals","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_social_engagement_signals","href":"/api-reference/operations/social-engagement/list-social-engagement-signals"},{"title":"Manage Social Engagement Monitored Profile","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/manage_social_engagement_monitored_profile","href":"/api-reference/operations/social-engagement/manage-social-engagement-monitored-profile"},{"title":"Update Social Engagement Signal","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/update_social_engagement_signal","href":"/api-reference/operations/social-engagement/update-social-engagement-signal"}]},{"group":"Audiences","pages":[{"title":"Add Audience Contacts","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/add_audience_contacts","href":"/api-reference/operations/audiences/add-audience-contacts"},{"title":"Attach Audience To Flow","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/attach_audience_to_flow","href":"/api-reference/operations/audiences/attach-audience-to-flow"},{"title":"Create Audience","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/create_audience","href":"/api-reference/operations/audiences/create-audience"},{"title":"Delete Audience","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/delete_audience","href":"/api-reference/operations/audiences/delete-audience"},{"title":"List Audiences","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_audiences","href":"/api-reference/operations/audiences/list-audiences"}]},{"group":"Dynamic Actions","pages":[{"title":"Add Contact Action","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/add_contact_action","href":"/api-reference/operations/dynamic-actions/add-contact-action"},{"title":"Add Dynamic Action","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/add_dynamic_action","href":"/api-reference/operations/dynamic-actions/add-dynamic-action"},{"title":"Create Contact Sequence","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/create_contact_sequence","href":"/api-reference/operations/dynamic-actions/create-contact-sequence"},{"title":"Find MCP Enrollment","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/find_mcp_enrollment","href":"/api-reference/operations/dynamic-actions/find-mcp-enrollment"}]},{"group":"Contact Data \u0026 Enrichment","pages":[{"title":"Add Exclusions","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/add_exclusions","href":"/api-reference/operations/contact-data-\u0026-enrichment/add-exclusions"},{"title":"Enrich Company","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/enrich_company","href":"/api-reference/operations/contact-data-\u0026-enrichment/enrich-company"},{"title":"Enrich Contact","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/enrich_contact","href":"/api-reference/operations/contact-data-\u0026-enrichment/enrich-contact"},{"title":"Enrich Email","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/enrich_email","href":"/api-reference/operations/contact-data-\u0026-enrichment/enrich-email"},{"title":"Enrich Phone","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/enrich_phone","href":"/api-reference/operations/contact-data-\u0026-enrichment/enrich-phone"},{"title":"Find Contact Data","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/find_contact_data","href":"/api-reference/operations/contact-data-\u0026-enrichment/find-contact-data"},{"title":"Get Contact Trace","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_contact_trace","href":"/api-reference/operations/contact-data-\u0026-enrichment/get-contact-trace"},{"title":"Get Exclusions","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_exclusions","href":"/api-reference/operations/contact-data-\u0026-enrichment/get-exclusions"},{"title":"Remove Exclusions","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/remove_exclusions","href":"/api-reference/operations/contact-data-\u0026-enrichment/remove-exclusions"},{"title":"Resync Exclusion Segment","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/resync_exclusion_segment","href":"/api-reference/operations/contact-data-\u0026-enrichment/resync-exclusion-segment"}]},{"group":"Enrollments","pages":[{"title":"Add Manual Flow Enrollment","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/add_manual_flow_enrollment","href":"/api-reference/operations/enrollments/add-manual-flow-enrollment"},{"title":"Cancel Awaiting Flow Items","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/cancel_awaiting_flow_items","href":"/api-reference/operations/enrollments/cancel-awaiting-flow-items"},{"title":"Cancel Flow Enrollments","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/cancel_flow_enrollments","href":"/api-reference/operations/enrollments/cancel-flow-enrollments"},{"title":"Enroll Awaiting Flow Items","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/enroll_awaiting_flow_items","href":"/api-reference/operations/enrollments/enroll-awaiting-flow-items"},{"title":"Get Flow Enrollment Candidate","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_flow_candidate","href":"/api-reference/operations/enrollments/get-flow-enrollment-candidate"},{"title":"Get Flow Enrollment","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_flow_enrollment","href":"/api-reference/operations/enrollments/get-flow-enrollment"},{"title":"List Enrollments","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_enrollments","href":"/api-reference/operations/enrollments/list-enrollments"},{"title":"List Flow Enrollment Candidates","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_flow_candidates","href":"/api-reference/operations/enrollments/list-flow-enrollment-candidates"},{"title":"List Flow Plan Enrollments","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_flow_plan_enrollments","href":"/api-reference/operations/enrollments/list-flow-plan-enrollments"},{"title":"Reenroll Flow Enrollments","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/reenroll_flow_enrollments","href":"/api-reference/operations/enrollments/reenroll-flow-enrollments"},{"title":"Update Flow Enrollment Candidates Custom Variables","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/update_flow_candidates_custom_variables","href":"/api-reference/operations/enrollments/update-flow-enrollment-candidates-custom-variables"},{"title":"Validate Flow Reenroll","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/validate_flow_reenroll","href":"/api-reference/operations/enrollments/validate-flow-reenroll"}]},{"group":"Tasks \u0026 Outreach Queues","pages":[{"title":"Approve Tasks","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/approve_tasks","href":"/api-reference/operations/tasks-\u0026-outreach-queues/approve-tasks"},{"title":"Complete Task","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/complete_task","href":"/api-reference/operations/tasks-\u0026-outreach-queues/complete-task"},{"title":"Edit Task Action","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/edit_task_action","href":"/api-reference/operations/tasks-\u0026-outreach-queues/edit-task-action"},{"title":"Get Outreach Queue Insights","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_outreach_queue_insights","href":"/api-reference/operations/tasks-\u0026-outreach-queues/get-outreach-queue-insights"},{"title":"List Email Send Queue","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_email_send_queue","href":"/api-reference/operations/tasks-\u0026-outreach-queues/list-email-send-queue"},{"title":"List LinkedIn Outreach Queue","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_linkedin_outreach_queue","href":"/api-reference/operations/tasks-\u0026-outreach-queues/list-linkedin-outreach-queue"},{"title":"Preview Task","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/preview_task","href":"/api-reference/operations/tasks-\u0026-outreach-queues/preview-task"},{"title":"Skip Task","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/skip_task","href":"/api-reference/operations/tasks-\u0026-outreach-queues/skip-task"},{"title":"Tasks Get Statuses","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/tasks_get_statuses","href":"/api-reference/operations/tasks-\u0026-outreach-queues/tasks-get-statuses"},{"title":"Tasks List","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/tasks_list","href":"/api-reference/operations/tasks-\u0026-outreach-queues/tasks-list"}]},{"group":"Flow Plans","pages":[{"title":"Create Draft Flow Plan","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/create_flow_plan","href":"/api-reference/operations/flow-plans/create-draft-flow-plan"},{"title":"Delete Flow Plan","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/delete_flow_plan","href":"/api-reference/operations/flow-plans/delete-flow-plan"},{"title":"Get Flow Available Variables","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_flow_available_variables","href":"/api-reference/operations/flow-plans/get-flow-available-variables"},{"title":"Get Flow Source Modes","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_flow_source_modes","href":"/api-reference/operations/flow-plans/get-flow-source-modes"},{"title":"Get Flow Workspace","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_flow_workspace","href":"/api-reference/operations/flow-plans/get-flow-workspace"},{"title":"List Flow Assignments","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_flow_assignments","href":"/api-reference/operations/flow-plans/list-flow-assignments"},{"title":"List Flow Plans","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_flow_plans","href":"/api-reference/operations/flow-plans/list-flow-plans"},{"title":"Manage Flow Publication","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/manage_flow_publication","href":"/api-reference/operations/flow-plans/manage-flow-publication"},{"title":"Replace Flow Root","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/replace_flow_root","href":"/api-reference/operations/flow-plans/replace-flow-root"},{"title":"Update Flow Custom Variables","description":"Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.\n\nUpdates custom input definitions atomically through add, updateLabels, and remove.\n\n\u003cdetails>\n\u003csummary>\u003cstrong>Detailed usage guidance\u003c/strong>\u003c/summary>\n\u003cul>\n\u003cli>Read get_flow_workspace.customVariables first for definitions, isUsed, canDelete, and referencePaths.\u003c/li>\n\u003cli>Each name may appear only once across all operations; overlapping or duplicate names are rejected.\u003c/li>\n\u003cli>Add requires a new name, updateLabels and remove require existing names.\u003c/li>\n\u003cli>Name and type cannot change; removal requires no references in the current tree, including branch expressions.\u003c/li>\n\u003cli>The final list supports up to 20 definitions.\u003c/li>\n\u003cli>Any invalid operation rejects the entire batch.\u003c/li>\n\u003cli>Preserves publication state, tree, saved audience/candidate values, and existing enrollment snapshots.\u003c/li>\n\u003cli>Returns all definitions and current usage.\u003c/li>\n\u003cli>If a concurrent edit conflicts, reload the workspace before retrying.\u003c/li>\n\u003c/ul>\n\u003c/details>","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/update_flow_custom_variables","href":"/api-reference/operations/flow-plans/update-flow-custom-variables"},{"title":"Update Flow Plan Settings","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/update_flow_plan","href":"/api-reference/operations/flow-plans/update-flow-plan-settings"}]},{"group":"Contact Discovery","pages":[{"title":"Discover Contacts","description":"CHARGED TOOL.\n\n\u003cdetails>\n\u003csummary>\u003cstrong>Detailed usage guidance\u003c/strong>\u003c/summary>\n\u003cul>\n\u003cli>Call get_guide with topic=contact_discovery before this tool.\u003c/li>\n\u003cli>Each generated Boolean filter expression must be at most 255 characters, including spaces, quotes, operators, parentheses, and exclusion prefixes; inclusion/exclusion values for the same field share this budget.\u003c/li>\n\u003cli>Role-title filters use exact matches; multiple values in the same title array match any listed value (OR).\u003c/li>\n\u003cli>Include the requested title plus up to 5 equivalent variants when available and within this limit, prioritizing requested titles and preserving role and seniority, unless the user requests only specific exact titles.\u003c/li>\n\u003cli>Reduce optional variants or split inclusion searches within the approved credit budget if needed; preserve other filters and never silently drop requested criteria.\u003c/li>\n\u003cli>Load one contact discovery page and return nextSteps for audience creation, pagination, background import, flow attachment, or enrollment.\u003c/li>\n\u003cli>For general discovery, suggest pageSize=1 first to return totalResultCount plus a preview contact.\u003c/li>\n\u003cli>After a preview or prior page, use returned nextPage as nextToken and request only additional rows; do not restart the same search without nextToken.\u003c/li>\n\u003cli>Reserves pageSize credits and charges 1 credit per returned profile row, up to 10 rows per call.\u003c/li>\n\u003c/ul>\n\u003c/details>","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/discover_contacts","href":"/api-reference/operations/contact-discovery/discover-contacts"},{"title":"Get Contact Discovery Audience Import Status","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_contact_discovery_audience_import_status","href":"/api-reference/operations/contact-discovery/get-contact-discovery-audience-import-status"},{"title":"Get Contact Discovery Industry Values","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_contact_discovery_industry_values","href":"/api-reference/operations/contact-discovery/get-contact-discovery-industry-values"},{"title":"Start Contact Discovery Audience Import","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/start_contact_discovery_audience_import","href":"/api-reference/operations/contact-discovery/start-contact-discovery-audience-import"}]},{"group":"Credits \u0026 Billing","pages":[{"title":"Get Credits Usage","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_credits_usage","href":"/api-reference/operations/credits-\u0026-billing/get-credits-usage"},{"title":"Get Feature Costs","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_feature_costs","href":"/api-reference/operations/credits-\u0026-billing/get-feature-costs"},{"title":"Get User Credit Usage","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_user_credit_usage","href":"/api-reference/operations/credits-\u0026-billing/get-user-credit-usage"},{"title":"List Credit Transactions","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_credit_transactions","href":"/api-reference/operations/credits-\u0026-billing/list-credit-transactions"},{"title":"List Flow Plan Credits Usage","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_flow_plan_credits_usage","href":"/api-reference/operations/credits-\u0026-billing/list-flow-plan-credits-usage"},{"title":"List Purchases","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_purchases","href":"/api-reference/operations/credits-\u0026-billing/list-purchases"}]},{"group":"Team \u0026 Account","pages":[{"title":"Get Current User","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_current_user","href":"/api-reference/operations/team-\u0026-account/get-current-user"},{"title":"Get Team Metrics","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_team_metrics","href":"/api-reference/operations/team-\u0026-account/get-team-metrics"},{"title":"List LinkedIn Team Connections","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_linkedin_team_connections","href":"/api-reference/operations/team-\u0026-account/list-linkedin-team-connections"},{"title":"List Team Members","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_team_members","href":"/api-reference/operations/team-\u0026-account/list-team-members"}]},{"group":"Guides","pages":[{"title":"Get Guide","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_guide","href":"/api-reference/operations/guides/get-guide"}]},{"group":"LinkedIn Inbox","pages":[{"title":"Get LinkedIn Unibox Conversation","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_linkedin_unibox_conversation","href":"/api-reference/operations/linkedin-inbox/get-linkedin-unibox-conversation"},{"title":"Get LinkedIn Unibox Counts","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/get_linkedin_unibox_counts","href":"/api-reference/operations/linkedin-inbox/get-linkedin-unibox-counts"},{"title":"List LinkedIn Unibox Conversations","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_linkedin_unibox_conversations","href":"/api-reference/operations/linkedin-inbox/list-linkedin-unibox-conversations"},{"title":"Send LinkedIn Unibox Message","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/send_linkedin_unibox_message","href":"/api-reference/operations/linkedin-inbox/send-linkedin-unibox-message"},{"title":"Update LinkedIn Unibox Conversation State","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/update_linkedin_unibox_conversation_state","href":"/api-reference/operations/linkedin-inbox/update-linkedin-unibox-conversation-state"}]},{"group":"HubSpot","pages":[{"title":"List HubSpot Lists","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/list_hubspot_lists","href":"/api-reference/operations/hubspot/list-hubspot-lists"},{"title":"Preview HubSpot List","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/preview_hubspot_list","href":"/api-reference/operations/hubspot/preview-hubspot-list"}]},{"group":"Support","pages":[{"title":"Report Issue","deprecated":null,"version":null,"openapi":"https://gateway.firsttouch.ai/api/public/openapi.json post /api/public/tools/report_issue","href":"/api-reference/operations/support/report-issue"}]}]}]},{"group":"Chrome Extension","pages":[{"title":"Overview","icon":"chrome","iconType":"brands","href":"/ChromeExtension/overview"},{"title":"The Action Bar","icon":"wand-magic-sparkles","href":"/ChromeExtension/action-bar"},{"title":"Enrichment","icon":"magnifying-glass","href":"/ChromeExtension/enrichment"},{"title":"Research","icon":"magnifying-glass-chart","href":"/ChromeExtension/research"}]},{"group":"References","pages":[{"title":"Safety Checklist","icon":"octagon-check","href":"/Safety-Checklist"},{"title":"Trust and Safety Policies","href":"/Trust-and-Safety-Policies"},{"title":"Data Processing \u0026 Security","sidebarTitle":"Data \u0026 Privacy","icon":"shield-check","href":"/data-compliance"},{"title":"Approved Subprocessors","icon":"server","href":"/approved-subprocessors"}]}]},"basePath":"","title":"Update Flow Plan Settings - First Touch Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}