Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.
What you get
Set a webhook URL on a workflow and Bolna sends your server one request per execution, at the moment that execution finishes. There is no request per node — the single payload carries the outcome plus the complete trail of every node the contact passed through, so you can reconstruct the whole journey without polling.Every execution reports when it finishes, not just the ones that finish happily. A contact whose call never connected, a run you canceled, and a run still in flight when you aborted its campaign all send a webhook, with a status and termination_reason that tell you which. Contacts still waiting to start when a campaign is aborted never begin an execution, so they send nothing.
This is separate from the call status webhook, which fires per phone call. A workflow that places two calls sends two call webhooks and one execution webhook.
Configuring it
The webhook lives in the workflow’s settings, so it applies to every execution of the workflow, including ones already running.
Dashboard
API
Open the workflow in the editor and click the Workflow settings (gear) icon in the toolbar.
Webhook Configuration in the Workflow settings panel
Turn on Send a webhook and enter your endpoint in Webhook URL.
To authenticate deliveries, turn on Add headers and enter them as a JSON object, e.g. {"X-Api-Key": "your-receiver-token"}. Saved values stay hidden as **********; leave the mask in place to keep a value.
Click Save.
Turning Send a webhook off and saving stops the webhook.
Setting a URL is what turns the webhook on. headers are sent with every delivery and are the usual way to authenticate the request as genuinely from Bolna.A few rules the URL has to satisfy:
https only, on port 443 or 8443.
No internal IP addresses. A host that is a private, loopback, link-local or carrier-NAT IP address is rejected, including alternate spellings of one.
Redirects are not followed. Point the URL at its final destination — a server that answers with a redirect is treated as not having received the webhook.
Changing it later
settings is merged into what is already stored, so you only send what changes:
Moving the URL to a different host or port drops the stored headers, so a credential only ever goes to the host it was entered for. Send the headers again in the same request. Renaming a workflow never touches its webhook.
Reading it back
GET /workflows/{workflow_id} returns the settings with every header value masked:
Header values are never returned. Because updates are merged, you never need them: to keep a header, leave it out of your update. Sending the mask ********** back as a value is rejected.
Testing it before you run anything
1
Publish the workflow
The sample is built from your published graph, so publish first.
2
Fire a test
Dashboard
API
Click Send Test in the Workflow settings panel. It is enabled once your webhook changes are saved and the workflow is published, and the result shows under the button.
delivered is true only for a 2xx reply. error_type: "http_error" means your server was reached and replied with anything else, redirects included; "unreachable" means it could not be contacted at all.
The sample is not a generic fixture. It walks the first branch of each node in your published workflow, so it carries your node ids and your own extraction field names — whatever you write against the sample will match what you receive in production.
Your own identifier for the contact, exactly as you uploaded it. This is what you join on.
status
How the execution ended: completed, failed, cancelled or aborted.
outcome
The end node’s classification — success, failure or neutral. null when the execution never reached an end node.
termination_reason
The end node’s label, or why it stopped without reaching one: internal_error, required_variable_missing, cancelled, campaign_aborted, zombie or terminated.
occurred_at
When the execution finished. A resent webhook carries the same value.
trail
Every node attempt in order, with the branch each one took and the values it produced. Always sent whole, however long the journey.
Each entry is one attempt at one node. A node reached twice through a retry appears twice, with attempt 1 and 2. to_node_id is the node it moved to next, and matched_case_index is which of that node’s branches matched — so the trail is the exact route through your workflow, not a summary of it.outputs keys are namespaced by what produced them: call.* from an agent node, extraction.* for each disposition you selected, response.* from an API node, callback.* from a callback node, whatsapp.* from a WhatsApp node.An agent node’s call.agent_version_id and call.agent_version_name name the saved version of the agent the call ran on. On a node with an A/B test, inputs also carries version_split.agent_version_id, the version the node picked for the contact, exactly as configured in the test.
Status combinations worth handling
status
outcome
What happened
completed
success / failure / neutral
Reached an end node. The outcome is the one you gave that end node.
cancelled
null
You canceled the execution.
failed
null
The execution could not continue — for example a required variable never resolved.
aborted
null
The campaign was aborted while this execution was in flight.
Reaching any end node produces status: "completed", including one you labeled a failure. To separate genuine successes from handled failures, read outcome, not status.
What to expect in delivery
Deliveries are not retried automatically. If your endpoint returns a non-2xx status or times out after 10 seconds, that delivery is not attempted again on its own. Return a 2xx as soon as you have durably accepted the payload, and do slow work afterwards. To deliver a missed webhook, resend it.
One delivery per execution. A duplicate is not expected, but a resend delivers the same payload again, so key your handler on execution_id.
No ordering between executions. Two executions finishing at the same moment can arrive in either order. Each payload is self-contained, so this only matters if you are sequencing across contacts yourself.
execution_id is stable and is the same id the execution APIs use, so you can always fetch the full record if a delivery is missed.
curl -X POST https://api.bolna.ai/workflow-executions/{execution_id}/webhook:resend \ -H "Authorization: Bearer YOUR_API_KEY"
It sends the webhook again to the workflow’s current URL and headers, with the payload the execution originally produced — the same occurred_at included. That makes it the way to recover a delivery your server missed, and to redeliver after correcting a wrong URL. The response is 202 once the webhook is queued; the execution must have finished, and its workflow must have a webhook configured.
Was this page helpful?
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Bolna Docs","description":"Quickly build and deploy conversational Voice AI agents","colors":{"primary":"#0073FF","light":"#64AAFF","dark":"#111111"},"logo":{"light":"https://mintcdn.com/bolna-54a2d4fe/VALWWMf7cQUV4GqY/logo/bolna-full-black.svg?fit=max\u0026auto=format\u0026n=VALWWMf7cQUV4GqY\u0026q=85\u0026s=9ad059134ba7338f4da43293d005f1e5","dark":"https://mintcdn.com/bolna-54a2d4fe/VALWWMf7cQUV4GqY/logo/bolna-full-white.svg?fit=max\u0026auto=format\u0026n=VALWWMf7cQUV4GqY\u0026q=85\u0026s=11287fcf7fd00922b6ea065d4247fe83","href":"https://www.bolna.ai/docs"},"favicon":{"light":"https://mintcdn.com/bolna-54a2d4fe/8f2PS3DzbOQMg6a5/favicon-bolna.svg?fit=max\u0026auto=format\u0026n=8f2PS3DzbOQMg6a5\u0026q=85\u0026s=65bdfd76b54fe55c7ea7edae0efb50e9","dark":"https://mintcdn.com/bolna-54a2d4fe/I_65jyMVzaUKonyY/favicon-bolna-white.svg?fit=max\u0026auto=format\u0026n=I_65jyMVzaUKonyY\u0026q=85\u0026s=afa80c7dbb9e76d1a9272c2f716b6aa6"},"api":{"openapi":"api-reference/openapi.yml"},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#111111"}},"navbar":{"links":[{"icon":"globe","href":"https://status.bolna.ai","label":"Status"},{"icon":"slack","href":"https://www.bolna.ai/join-slack","label":"Ask us on Slack"},{"icon":"gauge","href":"https://platform.bolna.ai/sign-up","label":"Platform"}]},"footer":{"socials":{"website":"https://platform.bolna.ai","github":"https://github.com/bolna-ai/bolna","slack":"https://www.bolna.ai/join-slack","linkedin":"https://www.linkedin.com/company/bolna-ai","youtube":"https://www.youtube.com/@BolnaVoiceAI","instagram":"https://www.instagram.com/bolna_dev"}},"seo":{"metatags":{"og:type":"website","og:site_name":"Bolna AI Documentation","canonical":"https://www.bolna.ai/docs"},"organization":{"id":"https://www.bolna.ai/#organization","name":"Bolna AI","legalName":"Whismurwave Inc.","url":"https://www.bolna.ai","logo":"https://www.bolna.ai/logos/logo-black.png","sameAs":["https://www.linkedin.com/company/bolna-ai/","https://www.ycombinator.com/companies/bolna-ai","https://github.com/bolna-ai","https://x.com/bolna_dev","https://www.youtube.com/@BolnaVoiceAI"]}},"fonts":{"family":"Anek Latin"},"styling":{"codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-BJ5QXHE52P"},"gtm":{"tagId":"GTM-53BBWG2J"}},"contextual":{"options":["copy","view","chatgpt","claude","add-mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bolna-54a2d4fe","hasAudioNarration":false,"actualSubdomain":"bolna-54a2d4fe","customDomains":["www.bolna.ai"],"gitSource":{"type":"github","owner":"bolna-ai","repo":"docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afb41c73f0541c4a2ab0f32","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Voice Agents","count":158},{"language":"default","tag":"API Reference","count":144},{"language":"default","tag":"Build","count":77},{"language":"default","tag":"Deploy","count":60},{"language":"default","tag":"Integrations","count":60},{"language":"default","tag":"Workflows","count":59},{"language":"default","tag":"Voice agents","count":48},{"language":"default","tag":"AI models","count":42},{"language":"default","tag":"Developers","count":41},{"language":"default","tag":"Telephony","count":36}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@bolna.ai"}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":":root{--bolna-black: #111111;--bolna-grey-05: #262626;--bolna-grey-04: #5b5c5c;--bolna-grey-02: #d0d0d0;--bolna-grey-01: #f2f2f2;--bolna-blue: #0073ff;--bolna-radius-button: 12px;--bolna-radius-card: 16px}#banner{background-color:var(--bolna-black)!important}img[src*=\"bolna-full-\"]{height:26px!important;width:auto!important;max-height:unset!important;max-width:unset!important}.update-container{flex-direction:column!important;align-items:stretch!important}.update-container>div:first-child{position:static!important;width:auto!important;margin-bottom:0.5rem}#content-container,#content-container :is(p,li,td,th,dd,dt,span,div){hyphens:none!important;-webkit-hyphens:none!important}#content-container code:not(pre code){word-break:normal!important;overflow-wrap:break-word!important}:is(h1,h2,h3,#page-title){letter-spacing:-0.02em}:root{font-size-adjust:0.546}:is(code,pre,kbd,samp){font-size-adjust:none}.card{border-radius:var(--bolna-radius-card)!important}.card:hover{border-color:var(--bolna-black)!important}html.dark .card:hover{border-color:#ffffff!important}"}],"page":{"pagePath":"workflows/execution-webhook","slug":"/workflows/execution-webhook","pageMetadata":{"title":"Workflow execution webhook","sidebarTitle":"Workflow webhooks","description":"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.","icon":"bell","iconType":"solid","last_reviewed":"2026-11-13","href":"/workflows/execution-webhook"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Frame,Heading,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`what-you-get`,children:`What you get`}),`\n`,_jsxs(_components.p,{children:[`Set a webhook URL on a workflow and Bolna sends your server `,_jsx(_components.strong,{children:`one request per execution`}),`, at the moment that execution finishes. There is no request per node — the single payload carries the outcome plus the complete trail of every node the contact passed through, so you can reconstruct the whole journey without polling.`]}),`\n`,_jsxs(_components.p,{children:[`Every execution reports when it finishes, not just the ones that finish happily. A contact whose call never connected, a run you canceled, and a run still in flight when you aborted its campaign all send a webhook, with a `,_jsx(_components.code,{children:`status`}),` and `,_jsx(_components.code,{children:`termination_reason`}),` that tell you which. Contacts still waiting to start when a campaign is aborted never begin an execution, so they send nothing.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This is separate from the `,_jsx(_components.a,{href:`/post-call/polling-call-status-webhooks`,children:`call status webhook`}),`, which fires per phone call. A workflow that places two calls sends two call webhooks and one execution webhook.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`configuring-it`,children:`Configuring it`}),`\n`,_jsxs(_components.p,{children:[`The webhook lives in the workflow’s `,_jsx(_components.code,{children:`settings`}),`, so it applies to every execution of the workflow, including ones already running.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Dashboard`,id:`dashboard`,children:[_jsxs(_components.p,{children:[`Open the workflow in the editor and click the `,_jsx(_components.strong,{children:`Workflow settings`}),` (gear) icon in the toolbar.`]}),_jsx(Frame,{caption:`Webhook Configuration in the Workflow settings panel`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/bolna-54a2d4fe/I6FqbsgFMmc3y_mK/images/workflows/editor/workflow_settings_webhook.png?fit=max\u0026auto=format\u0026n=I6FqbsgFMmc3y_mK\u0026q=85\u0026s=bcc3d6dd808e550212a72a17f9b823f7`,alt:`Workflow settings panel beside the canvas, with the Webhook Configuration card showing the Send a webhook toggle on, a Webhook URL, the Add headers toggle on with a Headers (JSON) field, and a Send Test button`,\"data-og-width\":`2180`,width:`2180`,\"data-og-height\":`956`,height:`956`,\"data-path\":`images/workflows/editor/workflow_settings_webhook.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/bolna-54a2d4fe/I6FqbsgFMmc3y_mK/images/workflows/editor/workflow_settings_webhook.png?w=280\u0026fit=max\u0026auto=format\u0026n=I6FqbsgFMmc3y_mK\u0026q=85\u0026s=3d7ae329d6cf8e736521b6b167d152f2 280w, https://mintcdn.com/bolna-54a2d4fe/I6FqbsgFMmc3y_mK/images/workflows/editor/workflow_settings_webhook.png?w=560\u0026fit=max\u0026auto=format\u0026n=I6FqbsgFMmc3y_mK\u0026q=85\u0026s=3c79dee68de5288ec23ae8f7c9511140 560w, https://mintcdn.com/bolna-54a2d4fe/I6FqbsgFMmc3y_mK/images/workflows/editor/workflow_settings_webhook.png?w=840\u0026fit=max\u0026auto=format\u0026n=I6FqbsgFMmc3y_mK\u0026q=85\u0026s=1172802f25da89f5b6e97c03a57fdad0 840w, https://mintcdn.com/bolna-54a2d4fe/I6FqbsgFMmc3y_mK/images/workflows/editor/workflow_settings_webhook.png?w=1100\u0026fit=max\u0026auto=format\u0026n=I6FqbsgFMmc3y_mK\u0026q=85\u0026s=cca46e169a4f794e387c53deeee114de 1100w, https://mintcdn.com/bolna-54a2d4fe/I6FqbsgFMmc3y_mK/images/workflows/editor/workflow_settings_webhook.png?w=1650\u0026fit=max\u0026auto=format\u0026n=I6FqbsgFMmc3y_mK\u0026q=85\u0026s=d4e799737e87c521ebb0b9966075325a 1650w, https://mintcdn.com/bolna-54a2d4fe/I6FqbsgFMmc3y_mK/images/workflows/editor/workflow_settings_webhook.png?w=2500\u0026fit=max\u0026auto=format\u0026n=I6FqbsgFMmc3y_mK\u0026q=85\u0026s=340652454b5d347bdb6f64d2a8d42fca 2500w`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Turn on `,_jsx(_components.strong,{children:`Send a webhook`}),` and enter your endpoint in `,_jsx(_components.strong,{children:`Webhook URL`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`To authenticate deliveries, turn on `,_jsx(_components.strong,{children:`Add headers`}),` and enter them as a JSON object, e.g. `,_jsx(_components.code,{children:`{\"X-Api-Key\": \"your-receiver-token\"}`}),`. Saved values stay hidden as `,_jsx(_components.code,{children:`**********`}),`; leave the mask in place to keep a value.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`Turning `,_jsx(_components.strong,{children:`Send a webhook`}),` off and saving stops the webhook.`]})]}),_jsxs(Tab,{title:`API`,id:`api`,children:[_jsxs(_components.p,{children:[`Set it with the `,_jsx(_components.a,{href:`/api-reference/workflows/update`,children:`Update Workflow API`}),`:`]}),_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`request`,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.bolna.ai/workflows/{workflow_id}`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"settings\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"webhook\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"url\": \"https://hooks.example.com/bolna/workflow\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"headers\": {\"X-Api-Key\": \"your-receiver-token\"}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})})]})]}),`\n`,_jsxs(_components.p,{children:[`Setting a URL is what turns the webhook on. `,_jsx(_components.code,{children:`headers`}),` are sent with every delivery and are the usual way to authenticate the request as genuinely from Bolna.`]}),`\n`,_jsx(_components.p,{children:`A few rules the URL has to satisfy:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`https`}),` only`]}),`, on port 443 or 8443.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No internal IP addresses.`}),` A host that is a private, loopback, link-local or carrier-NAT IP address is rejected, including alternate spellings of one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Redirects are not followed.`}),` Point the URL at its final destination — a server that answers with a redirect is treated as not having received the webhook.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`changing-it-later`,children:`Changing it later`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`settings`}),` is merged into what is already stored, so you only send what changes:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`To`}),_jsx(_components.th,{children:`Send`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Change the path, keeping the headers`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"settings\": {\"webhook\": {\"url\": \"https://hooks.example.com/v2\"}}}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Move to another host, with its headers`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"settings\": {\"webhook\": {\"url\": \"https://ingest.example.org/bolna\", \"headers\": {\"X-Api-Key\": \"...\"}}}}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Add or replace one header`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"settings\": {\"webhook\": {\"headers\": {\"X-Tenant\": \"acme\"}}}}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Remove one header`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"settings\": {\"webhook\": {\"headers\": {\"X-Tenant\": null}}}}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Stop sending webhooks`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"settings\": {\"webhook\": null}}`})})]})]})]}),`\n`,_jsx(_components.p,{children:`Moving the URL to a different host or port drops the stored headers, so a credential only ever goes to the host it was entered for. Send the headers again in the same request. Renaming a workflow never touches its webhook.`}),`\n`,_jsx(Heading,{level:`3`,id:`reading-it-back`,children:`Reading it back`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /workflows/{workflow_id}`}),` returns the settings with every header value masked:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"settings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"webhook\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://hooks.example.com/bolna/workflow\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"X-Api-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"**********\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Header values are never returned. Because updates are merged, you never need them: to keep a header, leave it out of your update. Sending the mask `,_jsx(_components.code,{children:`**********`}),` back as a value is rejected.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`testing-it-before-you-run-anything`,children:`Testing it before you run anything`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Publish the workflow`,children:_jsx(_components.p,{children:`The sample is built from your published graph, so publish first.`})}),_jsx(Step,{title:`Fire a test`,children:_jsxs(Tabs,{children:[_jsx(Tab,{title:`Dashboard`,id:`dashboard-2`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Send Test`}),` in the `,_jsx(_components.strong,{children:`Workflow settings`}),` panel. It is enabled once your webhook changes are saved and the workflow is published, and the result shows under the button.`]})}),_jsxs(Tab,{title:`API`,id:`api-2`,children:[_jsxs(_components.p,{children:[`Call the `,_jsx(_components.a,{href:`/api-reference/workflow-webhooks/test`,children:`Test Webhook API`}),`:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.bolna.ai/workflows/{workflow_id}/webhook:test`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`]})})})]})]})}),_jsxs(Step,{title:`Read the verdict`,children:[_jsx(_components.p,{children:`The API returns:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"webhook_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://hooks.example.com/bolna/workflow\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"workflow_version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sample_path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"n_start\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"n_call1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"n_extract\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"n_end\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sample_outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"delivered\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"http_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"response_body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`delivered`}),` is true only for a 2xx reply. `,_jsx(_components.code,{children:`error_type: \"http_error\"`}),` means your server was reached and replied with anything else, redirects included; `,_jsx(_components.code,{children:`\"unreachable\"`}),` means it could not be contacted at all.`]})]})]}),`\n`,_jsxs(_components.p,{children:[`The sample is not a generic fixture. It walks the first branch of each node in `,_jsx(_components.em,{children:`your`}),` published workflow, so it carries your node ids and your own extraction field names — whatever you write against the sample will match what you receive in production.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`the-payload`,children:`The payload`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`30`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`30`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"execution.terminal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"schema_version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"execution_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"exec:8f14e45f-...:CUST-9931\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"workflow_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"b6f1a2c4-...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"workflow_version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"campaign_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"8f14e45f-...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reference_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CUST-9931\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"termination_reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"promise kept\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"occurred_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-22T11:02:41Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"trail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"node_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"n_call1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"node_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"attempt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"to_node_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"n_extract\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"matched_case_index\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"inputs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"recipient\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+919999999999\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outputs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"call.status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"call.duration_s\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`148`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"call.agent_version_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3f9a7c2e-...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"call.agent_version_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"v2\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`What it tells you`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reference_id`})}),_jsx(_components.td,{children:`Your own identifier for the contact, exactly as you uploaded it. This is what you join on.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsxs(_components.td,{children:[`How the execution ended: `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`cancelled`}),` or `,_jsx(_components.code,{children:`aborted`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcome`})}),_jsxs(_components.td,{children:[`The end node’s classification — `,_jsx(_components.code,{children:`success`}),`, `,_jsx(_components.code,{children:`failure`}),` or `,_jsx(_components.code,{children:`neutral`}),`. `,_jsx(_components.code,{children:`null`}),` when the execution never reached an end node.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`termination_reason`})}),_jsxs(_components.td,{children:[`The end node’s label, or why it stopped without reaching one: `,_jsx(_components.code,{children:`internal_error`}),`, `,_jsx(_components.code,{children:`required_variable_missing`}),`, `,_jsx(_components.code,{children:`cancelled`}),`, `,_jsx(_components.code,{children:`campaign_aborted`}),`, `,_jsx(_components.code,{children:`zombie`}),` or `,_jsx(_components.code,{children:`terminated`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`occurred_at`})}),_jsx(_components.td,{children:`When the execution finished. A resent webhook carries the same value.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`trail`})}),_jsx(_components.td,{children:`Every node attempt in order, with the branch each one took and the values it produced. Always sent whole, however long the journey.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Every field is also described on the `,_jsx(_components.a,{href:`/api-reference/workflow-webhooks/execution-terminal`,children:`Execution webhook payload`}),` reference page.`]}),`\n`,_jsx(Heading,{level:`3`,id:`reading-the-trail`,children:`Reading the trail`}),`\n`,_jsxs(_components.p,{children:[`Each entry is one attempt at one node. A node reached twice through a retry appears twice, with `,_jsx(_components.code,{children:`attempt`}),` 1 and 2. `,_jsx(_components.code,{children:`to_node_id`}),` is the node it moved to next, and `,_jsx(_components.code,{children:`matched_case_index`}),` is which of that node’s branches matched — so the trail is the exact route through your workflow, not a summary of it.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`outputs`}),` keys are namespaced by what produced them: `,_jsx(_components.code,{children:`call.*`}),` from an agent node, `,_jsx(_components.code,{children:`extraction.*`}),` for each disposition you selected, `,_jsx(_components.code,{children:`response.*`}),` from an API node, `,_jsx(_components.code,{children:`callback.*`}),` from a callback node, `,_jsx(_components.code,{children:`whatsapp.*`}),` from a WhatsApp node.`]}),`\n`,_jsxs(_components.p,{children:[`An agent node’s `,_jsx(_components.code,{children:`call.agent_version_id`}),` and `,_jsx(_components.code,{children:`call.agent_version_name`}),` name the saved version of the agent the call ran on. On a node with an `,_jsx(_components.a,{href:`/workflows/ab-testing`,children:`A/B test`}),`, `,_jsx(_components.code,{children:`inputs`}),` also carries `,_jsx(_components.code,{children:`version_split.agent_version_id`}),`, the version the node picked for the contact, exactly as configured in the test.`]}),`\n`,_jsx(Heading,{level:`3`,id:`status-combinations-worth-handling`,children:`Status combinations worth handling`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`outcome`})}),_jsx(_components.th,{children:`What happened`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completed`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`success`}),` / `,_jsx(_components.code,{children:`failure`}),` / `,_jsx(_components.code,{children:`neutral`})]}),_jsxs(_components.td,{children:[`Reached an end node. The `,_jsx(_components.code,{children:`outcome`}),` is the one you gave that end node.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cancelled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`null`})}),_jsx(_components.td,{children:`You canceled the execution.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`null`})}),_jsx(_components.td,{children:`The execution could not continue — for example a required variable never resolved.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`aborted`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`null`})}),_jsx(_components.td,{children:`The campaign was aborted while this execution was in flight.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Reaching `,_jsx(_components.em,{children:`any`}),` end node produces `,_jsx(_components.code,{children:`status: \"completed\"`}),`, including one you labeled a failure. To separate genuine successes from handled failures, read `,_jsx(_components.code,{children:`outcome`}),`, not `,_jsx(_components.code,{children:`status`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`what-to-expect-in-delivery`,children:`What to expect in delivery`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Deliveries are not retried automatically.`}),` If your endpoint returns a non-2xx status or times out after 10 seconds, that delivery is not attempted again on its own. Return a 2xx as soon as you have durably accepted the payload, and do slow work afterwards. To deliver a missed webhook, `,_jsx(_components.a,{href:`#resending-a-webhook`,children:`resend it`}),`.`]})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`One delivery per execution.`}),` A duplicate is not expected, but a resend delivers the same payload again, so key your handler on `,_jsx(_components.code,{children:`execution_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No ordering between executions.`}),` Two executions finishing at the same moment can arrive in either order. Each payload is self-contained, so this only matters if you are sequencing across contacts yourself.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`execution_id`}),` is stable`]}),` and is the same id the `,_jsx(_components.a,{href:`/api-reference/workflow-executions/get`,children:`execution APIs`}),` use, so you can always fetch the full record if a delivery is missed.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`resending-a-webhook`,children:`Resending a webhook`}),`\n`,_jsxs(_components.p,{children:[`Call the `,_jsx(_components.a,{href:`/api-reference/workflow-webhooks/resend`,children:`Resend Webhook API`}),` with the execution’s id:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.bolna.ai/workflow-executions/{execution_id}/webhook:resend`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`It sends the webhook again to the workflow’s `,_jsx(_components.strong,{children:`current`}),` URL and headers, with the payload the execution originally produced — the same `,_jsx(_components.code,{children:`occurred_at`}),` included. That makes it the way to recover a delivery your server missed, and to redeliver after correcting a wrong URL. The response is `,_jsx(_components.code,{children:`202`}),` once the webhook is queued; the execution must have finished, and its workflow must have a webhook configured.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Workflow execution webhook","sidebarTitle":"Workflow webhooks","description":"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.","icon":"bell","iconType":"solid","last_reviewed":"2026-11-13","href":"/workflows/execution-webhook"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you get","slug":"what-you-get","depth":2,"children":[]},{"title":"Configuring it","slug":"configuring-it","depth":2,"children":[{"title":"Changing it later","slug":"changing-it-later","depth":3,"children":[]},{"title":"Reading it back","slug":"reading-it-back","depth":3,"children":[]}]},{"title":"Testing it before you run anything","slug":"testing-it-before-you-run-anything","depth":2,"children":[]},{"title":"The payload","slug":"the-payload","depth":2,"children":[{"title":"Reading the trail","slug":"reading-the-trail","depth":3,"children":[]},{"title":"Status combinations worth handling","slug":"status-combinations-worth-handling","depth":3,"children":[]}]},{"title":"What to expect in delivery","slug":"what-to-expect-in-delivery","depth":2,"children":[{"title":"Resending a webhook","slug":"resending-a-webhook","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/bolna-54a2d4fe/73314f84f6e30c14/custom.js","/docs/_mintlify/custom/bolna-54a2d4fe/786be19ebac8ab86/faq-schema.js"],"subdomain":"bolna-54a2d4fe","siteName":"Bolna Docs","title":"Workflow execution webhook - Bolna Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T08:13:17.804Z","originalFileLocation":"workflows/execution-webhook.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=\"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bolna Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_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=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Workflow execution webhook - Bolna Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bolna AI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.bolna.ai/docs/workflows/execution-webhook\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bolna-54a2d4fe.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Workflow+execution+webhook\u0026amp;description=Get+a+single+POST+to+your+server+every+time+a+workflow+execution+finishes%2C+carrying+the+outcome+and+the+full+path+the+contact+took+through+your+workflow.\u0026amp;theme=f2dcce2f7fc3b944c1c433e4\u0026amp;signature=62244694f501ba6302dc4dda1cd3b4d30a88d530a12726202a65f30a5a7ab253\">\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=\"Workflow execution webhook - Bolna Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bolna-54a2d4fe.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Workflow+execution+webhook\u0026amp;description=Get+a+single+POST+to+your+server+every+time+a+workflow+execution+finishes%2C+carrying+the+outcome+and+the+full+path+the+contact+took+through+your+workflow.\u0026amp;theme=f2dcce2f7fc3b944c1c433e4\u0026amp;signature=62244694f501ba6302dc4dda1cd3b4d30a88d530a12726202a65f30a5a7ab253\">\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=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bolna Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0073FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.bolna.ai/docs/workflows/execution-webhook\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/workflows/execution-webhook.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.bolna.ai/#organization\",\"name\":\"Bolna AI\",\"legalName\":\"Whismurwave Inc.\",\"url\":\"https://www.bolna.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://www.bolna.ai/logos/logo-black.png\"},\"sameAs\":[\"https://www.linkedin.com/company/bolna-ai/\",\"https://www.ycombinator.com/companies/bolna-ai\",\"https://github.com/bolna-ai\",\"https://x.com/bolna_dev\",\"https://www.youtube.com/@BolnaVoiceAI\"]},{\"@type\":\"WebSite\",\"@id\":\"https://www.bolna.ai/docs#website\",\"name\":\"Bolna Docs\",\"url\":\"https://www.bolna.ai/docs\",\"publisher\":{\"@id\":\"https://www.bolna.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.bolna.ai/docs/workflows/execution-webhook#webpage\",\"url\":\"https://www.bolna.ai/docs/workflows/execution-webhook\",\"name\":\"Workflow execution webhook\",\"description\":\"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.\",\"dateModified\":\"2026-11-16T08:13:17.804Z\",\"isPartOf\":{\"@id\":\"https://www.bolna.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.bolna.ai/docs/workflows/execution-webhook#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.bolna.ai/docs/workflows/execution-webhook#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Deploy\",\"item\":\"https://www.bolna.ai/docs/agents/deploy\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Workflows\",\"item\":\"https://www.bolna.ai/docs/workflows/introduction\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Workflow execution webhook\",\"item\":\"https://www.bolna.ai/docs/workflows/execution-webhook\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.bolna.ai/docs/workflows/execution-webhook#article\",\"headline\":\"Workflow execution webhook\",\"name\":\"Workflow execution webhook\",\"description\":\"Get a single POST to your server every time a workflow execution finishes, carrying the outcome and the full path the contact took through your workflow.\",\"url\":\"https://www.bolna.ai/docs/workflows/execution-webhook\",\"mainEntityOfPage\":{\"@id\":\"https://www.bolna.ai/docs/workflows/execution-webhook#webpage\"},\"dateModified\":\"2026-11-16T08:13:17.804Z\",\"publisher\":{\"@id\":\"https://www.bolna.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.bolna.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bolna Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bolna AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/workflows/execution-webhook.md","siteName":"Bolna Docs","nav":{"global":null,"tabs":[{"tab":"Overview","icon":"book","pages":[{"title":"Overview","href":""}]},{"tab":"Voice Agents","icon":"waveform-lines","groups":[{"group":" ","pages":[{"title":"Voice agents: build, deploy and monitor","sidebarTitle":"Overview","icon":"robot","href":"/agents/overview"}]},{"group":"Build","icon":"hammer","pages":[{"group":"Agent setup","icon":"sliders","root":{"title":"Configure voice AI agents in Bolna","sidebarTitle":"Agent builder overview","icon":"compass","iconType":"solid","href":"/agent-setup/overview"},"expanded":false,"pages":[{"title":"Configure multilingual agent prompts and hangup settings","sidebarTitle":"Prompt \u0026 greeting","icon":"file-lines","iconType":"solid","href":"/agent-setup/agent-tab"},{"title":"Single Prompt view for multilingual agents","sidebarTitle":"Single Prompt view","icon":"language","iconType":"solid","tag":"Beta","href":"/agent-setup/single-prompt-view"},{"title":"Choose and configure LLM models for voice AI","sidebarTitle":"Choose an LLM","icon":"brain","iconType":"solid","href":"/agent-setup/llm-tab"},{"title":"Configure languages, voice and transcription settings","sidebarTitle":"Voice \u0026 language","icon":"language","iconType":"solid","href":"/agent-setup/audio-tab"},{"title":"Configure voice AI latency and interruptions","sidebarTitle":"Interruptions \u0026 speed","icon":"gear","iconType":"solid","href":"/agent-setup/engine-tab"},{"title":"Configure telephony, noise, and call timing for voice AI","sidebarTitle":"Calling tab","icon":"phone","iconType":"solid","href":"/agent-setup/call-tab"},{"title":"Set up inbound calls \u0026 caller matching","sidebarTitle":"Inbound calling tab","icon":"phone-arrow-down","iconType":"solid","href":"/agent-setup/inbound-tab"},{"title":"Connect function tools and API integrations","sidebarTitle":"Connect tools and APIs","icon":"function","iconType":"solid","href":"/agent-setup/tools-tab"},{"title":"Set up webhooks and post-call extractions","sidebarTitle":"Extractions tab","icon":"chart-line","iconType":"solid","href":"/agent-setup/analytics-tab"},{"title":"Agent versions","sidebarTitle":"Agent versions","icon":"code-branch","iconType":"solid","href":"/agent-setup/agent-versions"},{"title":"Import agents","sidebarTitle":"Copy or import an agent","icon":"copy","iconType":"solid","href":"/agent-setup/copy-import-agent"}]},{"group":"Graph agents","icon":"diagram-nested","root":{"title":"Graph agents","sidebarTitle":"Graph agents overview","icon":"diagram-project","iconType":"solid","href":"/graph-agent/introduction"},"expanded":false,"pages":[{"title":"Using the graph agent editor","sidebarTitle":"Using the editor","icon":"pen-to-square","iconType":"solid","href":"/graph-agent/using-the-editor"},{"title":"Managing nodes","sidebarTitle":"Managing nodes","icon":"circle-nodes","iconType":"solid","href":"/graph-agent/managing-nodes"},{"title":"Managing transitions","sidebarTitle":"Managing transitions","icon":"arrow-right-arrow-left","iconType":"solid","href":"/graph-agent/managing-transitions"},{"title":"Edges \u0026 routing","sidebarTitle":"Edges \u0026 routing","icon":"route","iconType":"solid","href":"/graph-agent/edges-and-routing"},{"title":"Router nodes","sidebarTitle":"Router nodes","icon":"diagram-project","iconType":"solid","href":"/graph-agent/router-nodes"},{"title":"Static nodes \u0026 silence repeat","sidebarTitle":"Static nodes","icon":"volume","iconType":"solid","href":"/graph-agent/static-nodes"},{"title":"Variables","sidebarTitle":"Variables","icon":"brackets-curly","iconType":"solid","href":"/graph-agent/variables"},{"title":"Agent setup","sidebarTitle":"Agent setup","icon":"sliders","iconType":"solid","href":"/graph-agent/settings"},{"title":"Tools \u0026 knowledge base","sidebarTitle":"Tools \u0026 RAG","icon":"screwdriver-wrench","iconType":"solid","href":"/graph-agent/tools-and-rag"},{"title":"Real-time event injection","sidebarTitle":"Event injection","icon":"bolt","iconType":"solid","href":"/graph-agent/event-injection"},{"title":"Testing your agent","sidebarTitle":"Testing","icon":"flask","iconType":"solid","href":"/graph-agent/testing"},{"title":"Validation","sidebarTitle":"Validation","icon":"circle-check","iconType":"solid","href":"/graph-agent/validation"},{"title":"Debugging graph agents","sidebarTitle":"Debug a graph agent","icon":"bug","iconType":"solid","href":"/graph-agent/debugging"},{"title":"Version history","sidebarTitle":"Version history","icon":"clock-rotate-left","iconType":"solid","href":"/graph-agent/version-history"},{"title":"Import \u0026 export","sidebarTitle":"Import / export","icon":"file-export","iconType":"solid","href":"/graph-agent/import-export"},{"title":"Full example","sidebarTitle":"Full example","icon":"file-code","iconType":"solid","href":"/graph-agent/full-example"}]},{"group":"Prompts","icon":"file-lines","root":{"title":"Prompting guide and best practices for Bolna voice AI","sidebarTitle":"Write better prompts","icon":"wand-magic-sparkles","iconType":"solid","href":"/prompting/introduction"},"expanded":false,"pages":[{"title":"Use dynamic variables to personalize voice AI calls","sidebarTitle":"Dynamic variables","icon":"code","iconType":"solid","href":"/prompting/using-context"}]},{"group":"Knowledge base","icon":"book","root":{"title":"Knowledge base for voice AI agents","sidebarTitle":"Overview","icon":"book","iconType":"solid","href":"/knowledge-base"},"expanded":false,"pages":[{"title":"Add PDFs and URLs to a knowledge base","sidebarTitle":"Add PDFs and URLs","icon":"file-arrow-up","iconType":"solid","href":"/knowledge-base/add-sources"},{"title":"Manage and connect knowledge bases","sidebarTitle":"Manage and connect","icon":"link","iconType":"solid","href":"/knowledge-base/manage-and-connect"}]},{"group":"Voices","icon":"microphone-lines","expanded":false,"pages":[{"title":"Clone your voice","sidebarTitle":"Clone a voice","icon":"microphone","iconType":"solid","href":"/clone-voices"},{"title":"Importing your voices to use with Bolna voice AI","sidebarTitle":"Import a voice","icon":"cloud-arrow-up","iconType":"solid","href":"/import-voices"},{"title":"Control how your agent pronounces words","sidebarTitle":"Pronunciation","icon":"spell-check","iconType":"solid","href":"/customizations/pronunciation"}]},{"group":"Languages \u0026 transcripts","icon":"language","root":{"title":"Supported languages","sidebarTitle":"Supported languages","icon":"language","iconType":"solid","href":"/customizations/supported-languages"},"expanded":false,"pages":[{"title":"Improve transcription accuracy with keywords and context","sidebarTitle":"Keywords and context","icon":"bullseye-arrow","iconType":"solid","href":"/customizations/asr-keywords-and-context"},{"title":"Capturing precise transcripts in Bolna voice AI","sidebarTitle":"Precise transcripts","icon":"message-dots","iconType":"solid","href":"/customizations/capturing-precise-transcripts"}]},{"group":"Multilingual","icon":"earth-americas","root":{"title":"Set up multilingual voice AI agents","sidebarTitle":"Multilingual setup","icon":"earth-americas","iconType":"solid","href":"/customizations/multilingual-languages-support"},"expanded":false,"pages":[{"title":"Multilingual agent quickstart","sidebarTitle":"Multilingual quickstart","icon":"earth-americas","iconType":"solid","href":"/quickstarts/multilingual"},{"title":"How language switching works","sidebarTitle":"Language switching","icon":"ear-listen","iconType":"solid","href":"/customizations/language-switching-behavior"},{"title":"Start a call in a chosen language","sidebarTitle":"Starting language","icon":"flag","iconType":"solid","href":"/customizations/start-call-in-language"},{"title":"Auto-detect and switch languages in Bolna voice AI","sidebarTitle":"Auto-switch mid-call","icon":"shuffle","iconType":"solid","href":"/customizations/auto-switch-multilingual-messages"},{"title":"Multilingual config reference","sidebarTitle":"Config reference","icon":"code","iconType":"solid","href":"/customizations/multilingual-config-reference"},{"title":"Writing prompts in non-English languages","sidebarTitle":"Non-English prompts","icon":"language","iconType":"solid","href":"/writing-prompts-in-non-english-languages"}]},{"group":"Languages","icon":"globe","root":{"title":"Indian language voice agents on Bolna","sidebarTitle":"Overview","icon":"language","iconType":"solid","href":"/customizations/languages/overview"},"expanded":false,"pages":[{"title":"Build a Hindi voice agent on Bolna","sidebarTitle":"Hindi voice agent","icon":"language","iconType":"solid","href":"/customizations/hindi-voice-agent"},{"title":"Build a Bengali voice agent on Bolna","sidebarTitle":"Bengali","icon":"language","iconType":"solid","href":"/customizations/languages/bengali"},{"title":"Build a Tamil voice agent on Bolna","sidebarTitle":"Tamil","icon":"language","iconType":"solid","href":"/customizations/languages/tamil"},{"title":"Build a Telugu voice agent on Bolna","sidebarTitle":"Telugu","icon":"language","iconType":"solid","href":"/customizations/languages/telugu"},{"title":"Build a Marathi voice agent on Bolna","sidebarTitle":"Marathi","icon":"language","iconType":"solid","href":"/customizations/languages/marathi"},{"title":"Build a Gujarati voice agent on Bolna","sidebarTitle":"Gujarati","icon":"language","iconType":"solid","href":"/customizations/languages/gujarati"},{"title":"Build a Kannada voice agent on Bolna","sidebarTitle":"Kannada","icon":"language","iconType":"solid","href":"/customizations/languages/kannada"},{"title":"Build a Malayalam voice agent on Bolna","sidebarTitle":"Malayalam","icon":"language","iconType":"solid","href":"/customizations/languages/malayalam"},{"title":"Build a Punjabi voice agent on Bolna","sidebarTitle":"Punjabi","icon":"language","iconType":"solid","href":"/customizations/languages/punjabi"},{"title":"Build an Odia voice agent on Bolna","sidebarTitle":"Odia","icon":"language","iconType":"solid","href":"/customizations/languages/odia"},{"title":"Build an Urdu voice agent on Bolna","sidebarTitle":"Urdu","icon":"language","iconType":"solid","href":"/customizations/languages/urdu"}]},{"group":"Tools \u0026 actions","icon":"screwdriver-wrench","root":{"title":"Function calling for voice AI agents","sidebarTitle":"How tool calling works","icon":"function","iconType":"solid","href":"/tool-calling/introduction"},"expanded":false,"pages":[{"title":"Transfer Live calls to human agents with Bolna voice AI","sidebarTitle":"Transfer calls","icon":"phone-arrow-right","iconType":"solid","href":"/tool-calling/transfer-calls"},{"title":"Search the web during live calls with Bolna Voice AI","sidebarTitle":"Web search","icon":"globe","iconType":"solid","href":"/tool-calling/web-search"},{"group":"Custom functions","icon":"code","root":{"title":"Custom function calls: Complete guide for Bolna voice AI","sidebarTitle":"Call your own API","icon":"code","iconType":"solid","href":"/tool-calling/custom-function-calls"},"pages":[{"title":"Custom function schema reference","sidebarTitle":"Schema reference","icon":"brackets-curly","iconType":"solid","href":"/tool-calling/custom-function-schema"},{"title":"Custom function examples","sidebarTitle":"Examples","icon":"code","iconType":"solid","href":"/tool-calling/custom-function-examples"},{"title":"Using variables in custom functions","sidebarTitle":"Variables \u0026 context","icon":"brackets-curly","iconType":"solid","href":"/tool-calling/custom-function-variables"},{"title":"Pre-call webhooks for custom functions","sidebarTitle":"Pre-call webhooks","icon":"webhook","iconType":"solid","href":"/tool-calling/pre-call-webhooks"}]},{"title":"Check calendar slots with Bolna and Cal.com","sidebarTitle":"Check availability","icon":"calendar-range","iconType":"solid","href":"/tool-calling/fetch-calendar-slots"},{"title":"Book calendar slots with Bolna voice AI and Cal.com","sidebarTitle":"Book an appointment","icon":"calendar-check","iconType":"solid","href":"/tool-calling/book-calendar-slots"},{"title":"Fetching dynamic date and time with Bolna voice AI","sidebarTitle":"Date and time","icon":"clock","iconType":"solid","href":"/tool-calling/fetch-date-and-time"}]},{"group":"Agent templates","icon":"clone","root":{"title":"Agents Library","sidebarTitle":"Agents library","icon":"head-side-gear","iconType":"solid","href":"/agent-templates"},"expanded":false,"pages":[{"group":"E-commerce","icon":"cart-shopping","pages":[{"title":"Customer support agent","sidebarTitle":"Customer support agent","icon":"headset","iconType":"solid","href":"/agent-templates/customer-support-agent"},{"title":"Cart abandonment agent","sidebarTitle":"Cart abandonment agent","icon":"cart-shopping","iconType":"solid","href":"/agent-templates/cart-abandonment-agent"},{"title":"COD confirmation agent","sidebarTitle":"COD confirmation agent","icon":"truck-fast","iconType":"solid","href":"/agent-templates/cod-confirmation-agent"}]},{"group":"BFSI","icon":"building-columns","pages":[{"title":"Announcements agent","sidebarTitle":"Announcements agent","icon":"bullhorn","iconType":"solid","href":"/agent-templates/announcements-agent"},{"title":"Reminders agent","sidebarTitle":"Reminders agent","icon":"clock","iconType":"solid","href":"/agent-templates/reminders-agent"},{"title":"Sales - credit card agent","sidebarTitle":"Sales: credit card agent","icon":"credit-card","iconType":"solid","href":"/agent-templates/sales-credit-card-agent"},{"title":"Sales - loans agent","sidebarTitle":"Sales: loans agent","icon":"hand-holding-dollar","iconType":"solid","href":"/agent-templates/sales-loans-agent"}]},{"group":"Hospitality","icon":"hotel","pages":[{"title":"Front desk agent","sidebarTitle":"Front desk agent","icon":"bell-concierge","iconType":"solid","href":"/agent-templates/front-desk-agent"},{"title":"Salon booking agent","sidebarTitle":"Salon booking agent","icon":"scissors","iconType":"solid","href":"/agent-templates/salon-booking-agent"},{"title":"Dentist appointment agent","sidebarTitle":"Dentist appointments","icon":"tooth","iconType":"solid","href":"/agent-templates/dentist-appointment-agent"},{"title":"Surveys agent","sidebarTitle":"Surveys agent","icon":"clipboard-question","iconType":"solid","href":"/agent-templates/surveys-agent"}]},{"group":"More industries","icon":"industry","pages":[{"title":"Recruitment agent","sidebarTitle":"Recruitment agent","icon":"user-tie","iconType":"solid","href":"/agent-templates/recruitment-agent"},{"title":"Lead qualification agent","sidebarTitle":"Lead qualification agent","icon":"magnifying-glass-chart","iconType":"solid","href":"/agent-templates/lead-qualification-agent"},{"title":"Onboarding agent","sidebarTitle":"Onboarding agent","icon":"user-plus","iconType":"solid","href":"/agent-templates/onboarding-agent"},{"title":"Property tech agent","sidebarTitle":"Property tech agent","icon":"house","iconType":"solid","href":"/agent-templates/property-tech-agent"},{"title":"Weekend planner agent","sidebarTitle":"Weekend planner agent","icon":"calendar-days","iconType":"solid","href":"/agent-templates/weekend-planner-agent"}]}]}]},{"group":"Deploy","icon":"rocket","pages":[{"title":"Deploy your voice agent","sidebarTitle":"Overview","icon":"rocket","href":"/agents/deploy"},{"group":"Phone numbers","icon":"hashtag","root":{"title":"Buy phone numbers for your Bolna voice AI agents","sidebarTitle":"Buy a number from Bolna","icon":"phone-plus","iconType":"solid","href":"/buying-phone-numbers"},"expanded":false,"pages":[{"title":"How to get 140 \u0026 160-series phone numbers in India","sidebarTitle":"Indian 140/160 numbers","icon":"phone-office","iconType":"solid","href":"/obtaining-regulated-phone-numbers"},{"title":"Truecaller verification for phone numbers","sidebarTitle":"Truecaller verification","icon":"shield-check","iconType":"solid","href":"/truecaller-verification"},{"group":"Phone number compliance","icon":"file-shield","root":{"title":"Phone number compliance requirements for India - Bolna AI","sidebarTitle":"India DLT compliance","icon":"file-certificate","iconType":"solid","href":"/compliance-application/introduction"},"pages":[{"title":"Submit phone number compliance application","sidebarTitle":"Submit an application","icon":"file-arrow-up","iconType":"solid","href":"/compliance-application/how-to-submit-guide"}]}]},{"group":"Outbound calls","icon":"phone-arrow-up-right","root":{"title":"Make outbound calls using Bolna voice AI agents","sidebarTitle":"Single outbound call","icon":"phone-arrow-up-right","iconType":"solid","href":"/outbound/making-calls"},"expanded":false,"pages":[{"title":"Automate and schedule calls using batches","sidebarTitle":"Batch calling","icon":"file-spreadsheet","iconType":"solid","href":"/outbound/batch-calling"},{"title":"Batch calling quickstart","sidebarTitle":"Batch calling via API","icon":"layer-group","iconType":"solid","href":"/quickstarts/batch"},{"title":"Auto-retry for failed calls","sidebarTitle":"Auto-retry calls","icon":"arrow-rotate-right","iconType":"solid","href":"/outbound/auto-retry"},{"title":"Calling guardrails for outbound calls","sidebarTitle":"Calling guardrails","icon":"clock","iconType":"solid","href":"/outbound/calling-guardrails"},{"title":"Hangup and disconnect Bolna voice AI calls","sidebarTitle":"End a call automatically","icon":"phone-hangup","iconType":"solid","href":"/outbound/hangup-calls"}]},{"title":"A/B test voice agent prompts and versions","sidebarTitle":"A/B testing","icon":"flask","iconType":"solid","href":"/agents/ab-testing"},{"group":"Workflows","icon":"diagram-project","root":{"title":"Workflows introduction","sidebarTitle":"Workflows overview","icon":"diagram-project","iconType":"solid","href":"/workflows/introduction"},"tag":"BETA","expanded":false,"pages":[{"title":"Workflow quickstart","sidebarTitle":"Quickstart","icon":"rocket","iconType":"solid","href":"/workflows/quickstart"},{"group":"Build a workflow","icon":"pen-ruler","root":{"title":"Using the workflow editor","sidebarTitle":"Using the editor","icon":"pen-to-square","iconType":"solid","href":"/workflows/using-the-editor"},"expanded":false,"pages":[{"title":"Workflow nodes","sidebarTitle":"Nodes","icon":"circle-nodes","iconType":"solid","href":"/workflows/nodes"},{"title":"Workflow callback node","sidebarTitle":"Callback node","icon":"reply","iconType":"solid","href":"/workflows/callback"},{"title":"Pause a journey until your system responds","sidebarTitle":"Callback API guide","icon":"hourglass-half","iconType":"solid","href":"/workflows/callback-guide"},{"title":"A/B test agent versions in workflows","sidebarTitle":"A/B testing","icon":"flask","iconType":"solid","href":"/workflows/ab-testing"},{"title":"Workflow conditions and variables","sidebarTitle":"Conditions \u0026 variables","icon":"code-branch","iconType":"solid","href":"/workflows/conditions-and-variables"},{"title":"Send WhatsApp messages with AiSensy","sidebarTitle":"WhatsApp via AiSensy","icon":"whatsapp","iconType":"brands","href":"/workflows/aisensy-whatsapp"}]},{"title":"Workflow campaigns","sidebarTitle":"Campaigns","description":"Run a published workflow over thousands of contacts: create a campaign, upload entries as CSV or JSON, start it, and track progress with per-node reports.","icon":"bullhorn","iconType":"solid","href":"/workflows/campaigns"},{"group":"Workflow webhooks","icon":"webhook","root":{"title":"Workflow execution webhook","sidebarTitle":"Workflow webhooks","icon":"bell","iconType":"solid","href":"/workflows/execution-webhook"},"expanded":false,"pages":[{"title":"Execution webhook payload","sidebarTitle":"Webhook payload","description":"The POST sent to a workflow's webhook URL once each execution finishes: how it ended, and every node the contact passed through.","openapi":"api-reference/openapi.yml webhook executionTerminal","href":"/api-reference/workflow-webhooks/execution-terminal"}]},{"title":"Graph agents vs workflows: which one to use","sidebarTitle":"Compare to graph agents","icon":"code-branch","iconType":"solid","href":"/graph-agent/graph-agents-vs-workflows"}]},{"group":"Inbound calls","icon":"phone-arrow-down-left","root":{"title":"Handle inbound calls with Bolna voice AI agents","sidebarTitle":"Receive inbound calls","icon":"phone-arrow-down-left","iconType":"solid","href":"/inbound/receiving-calls"},"expanded":false,"pages":[{"title":"Inbound quickstart","sidebarTitle":"Receive your first call","icon":"phone-arrow-down-left","iconType":"solid","href":"/quickstarts/inbound"},{"title":"Set up IVR for inbound calls in Bolna voice AI","sidebarTitle":"Build an IVR menu","icon":"phone-intercom","iconType":"solid","href":"/inbound/ivr"},{"title":"DTMF (keypad input)","sidebarTitle":"Keypad input (DTMF)","icon":"keyboard","iconType":"solid","href":"/inbound/dtmf"},{"title":"Dynamically identify incoming callers","sidebarTitle":"Identify the caller","icon":"filter-list","iconType":"solid","href":"/customizations/identify-incoming-callers"},{"title":"Block incoming callers by number or prefix","sidebarTitle":"Block unwanted callers","icon":"phone-slash","iconType":"solid","href":"/customizations/block-incoming-callers"}]},{"group":"Web calls","icon":"globe","root":{"title":"Web Call SDK","sidebarTitle":"Web Call SDK","icon":"browser","iconType":"solid","href":"/developer-resources/sdks/web-call"},"expanded":false,"pages":[{"title":"Web Call SDK starter templates","sidebarTitle":"Starter templates","icon":"copy","iconType":"solid","href":"/developer-resources/sdks/web-call-templates"},{"title":"Web Call SDK API reference","sidebarTitle":"SDK API reference","icon":"code","iconType":"solid","href":"/developer-resources/sdks/web-call-api"}]},{"group":"Telephony providers","icon":"tower-cell","root":{"title":"Explore telephony integrations with Bolna voice AI","sidebarTitle":"Choose a telephony setup","icon":"scale-balanced","href":"/supported-telephony-providers"},"expanded":false,"pages":[{"group":"Twilio","icon":"phone","root":{"title":"Integrate Twilio with Bolna for enhanced calling","sidebarTitle":"Using Twilio","icon":"phone","href":"/twilio"},"pages":[{"title":"Securely link your Twilio account to Bolna","sidebarTitle":"Connect account","icon":"plug","href":"/twilio/connect-provider"},{"title":"Make outbound calls via Twilio with Bolna voice AI","sidebarTitle":"Outbound calls","icon":"phone-arrow-up-right","href":"/twilio/outbound-calls"},{"title":"Using Twilio for inbound calls","sidebarTitle":"Inbound calls","icon":"phone-arrow-down-left","href":"/twilio/receive-calls"},{"title":"Serving Twilio on prem","sidebarTitle":"On-premise","icon":"server","href":"/twilio/on-prem"}]},{"group":"Plivo","icon":"phone","root":{"title":"Enhance call capabilities with Bolna's Plivo integration","sidebarTitle":"Using Plivo","icon":"phone","href":"/plivo"},"pages":[{"title":"Link your Plivo account to Bolna for voice AI","sidebarTitle":"Connect account","icon":"plug","href":"/plivo/connect-provider"},{"title":"Initiate outbound calls via Plivo with Bolna voice AI","sidebarTitle":"Outbound calls","icon":"phone-arrow-up-right","href":"/plivo/outbound-calls"},{"title":"Using Plivo for inbound calls","sidebarTitle":"Inbound calls","icon":"phone-arrow-down-left","href":"/plivo/receive-calls"}]},{"group":"Exotel","icon":"phone","root":{"title":"Exotel integration with Bolna voice AI","sidebarTitle":"Using Exotel","icon":"phone","href":"/exotel"},"pages":[{"title":"Connect your Exotel account to Bolna","sidebarTitle":"Connect account","icon":"plug","href":"/exotel/connect-provider"},{"title":"Setup Exotel with Bolna for outbound calling","sidebarTitle":"Outbound app setup","icon":"gear","href":"/exotel/setup-app-for-outbound-calls"},{"title":"Setup Exotel with Bolna for inbound calling","sidebarTitle":"Inbound app setup","icon":"gears","href":"/exotel/setup-app-for-inbound-calls"},{"title":"Make outbound calls with Exotel and Bolna","sidebarTitle":"Outbound calls","icon":"phone-arrow-up-right","href":"/exotel/outbound-calls"}]},{"group":"Vobiz","icon":"phone","root":{"title":"Vobiz Integration: Make AI Outbound Calls with Vobiz","sidebarTitle":"Using Vobiz","icon":"phone","href":"/vobiz"},"pages":[{"title":"Link your Vobiz account to Bolna for voice AI","sidebarTitle":"Connect account","icon":"plug","href":"/vobiz/connect-provider"},{"title":"Initiate outbound calls via Vobiz with Bolna voice AI","sidebarTitle":"Outbound calls","icon":"phone-arrow-up-right","href":"/vobiz/outbound-calls"}]}]},{"group":"SIP trunks","icon":"network-wired","root":{"title":"SIP trunks: connect your own carrier to Bolna","sidebarTitle":"Overview","icon":"network-wired","iconType":"solid","href":"/sip-trunking/overview"},"expanded":false,"pages":[{"title":"Connect your carrier to Bolna with a SIP trunk","sidebarTitle":"Connect your carrier","icon":"plug","iconType":"solid","href":"/sip-trunking/connect-carrier"},{"group":"Carrier guides","icon":"building","root":{"title":"SIP trunk carrier guides","sidebarTitle":"Carrier guides","icon":"building","iconType":"solid","href":"/sip-trunking/carriers"},"expanded":false,"pages":[{"title":"Connect Acefone to Bolna with a SIP trunk","sidebarTitle":"Acefone","icon":"https://mintlify.s3.us-west-1.amazonaws.com/bolna-54a2d4fe/images/icons/acefone-logo.png","iconType":"solid","href":"/sip-trunking/acefone"},{"title":"Connect Airtel to Bolna with a SIP trunk","sidebarTitle":"Airtel","icon":"https://mintlify.s3.us-west-1.amazonaws.com/bolna-54a2d4fe/images/icons/airtel-logo.svg","iconType":"solid","href":"/sip-trunking/airtel"},{"title":"Connect Plivo to Bolna with a SIP trunk","sidebarTitle":"Plivo","icon":"https://mintlify.s3.us-west-1.amazonaws.com/bolna-54a2d4fe/images/icons/plivo-logo.svg","iconType":"solid","href":"/sip-trunking/plivo"},{"title":"Connect Telnyx to Bolna with a SIP trunk","sidebarTitle":"Telnyx","icon":"https://mintlify.s3.us-west-1.amazonaws.com/bolna-54a2d4fe/images/icons/telnyx-logo.png","iconType":"solid","href":"/sip-trunking/telnyx"},{"title":"Connect Twilio to Bolna with a SIP trunk","sidebarTitle":"Twilio","icon":"https://mintlify.s3.us-west-1.amazonaws.com/bolna-54a2d4fe/images/icons/twilio-logo.svg","iconType":"solid","href":"/sip-trunking/twilio"},{"title":"Connect Vobiz to Bolna with a SIP trunk","sidebarTitle":"Vobiz","icon":"https://mintlify.s3.us-west-1.amazonaws.com/bolna-54a2d4fe/images/icons/vobiz-logo.svg","iconType":"solid","href":"/sip-trunking/vobiz"},{"title":"Connect VoiceLink to Bolna with a SIP trunk","sidebarTitle":"VoiceLink","icon":"https://mintlify.s3.us-west-1.amazonaws.com/bolna-54a2d4fe/images/icons/voicelink-logo.png","iconType":"solid","href":"/sip-trunking/voicelink"}]},{"title":"Receive inbound calls on a SIP trunk","sidebarTitle":"Inbound calls","icon":"phone-arrow-down-left","iconType":"solid","href":"/sip-trunking/inbound-calls"},{"title":"Make outbound calls through a SIP trunk","sidebarTitle":"Outbound calls","icon":"phone-arrow-up-right","iconType":"solid","href":"/sip-trunking/outbound-calls"},{"title":"Transfer SIP trunk calls to a person","sidebarTitle":"Call transfer","icon":"phone-arrow-right","iconType":"solid","href":"/sip-trunking/call-transfer"},{"title":"SIP headers on SIP trunk calls","sidebarTitle":"SIP headers","icon":"tag","iconType":"solid","href":"/sip-trunking/sip-headers"},{"title":"Troubleshoot SIP trunk calls","sidebarTitle":"Troubleshooting","icon":"stethoscope","iconType":"solid","href":"/sip-trunking/troubleshooting"},{"group":"Legacy SIP trunks (deprecated)","icon":"box-archive","root":{"title":"Bring your own SIP trunk to Bolna voice AI","sidebarTitle":"How SIP trunking works","icon":"utility-pole","iconType":"solid","href":"/sip-trunking/introduction"},"expanded":false,"pages":[{"title":"SIP trunking for voice AI on Bolna","sidebarTitle":"SIP trunking explained","icon":"tower-broadcast","iconType":"solid","href":"/sip-trunking/tutorials/introduction"},{"group":"Create a trunk","icon":"plus","expanded":false,"pages":[{"title":"Create a SIP trunk on Twilio for Bolna","sidebarTitle":"Twilio trunk","icon":"server","iconType":"solid","href":"/sip-trunking/tutorials/twilio-setup"},{"title":"Create a SIP trunk on Plivo for Bolna","sidebarTitle":"Plivo trunk","icon":"server","iconType":"solid","href":"/sip-trunking/tutorials/plivo-setup"}]},{"group":"Register on Bolna","icon":"link","root":{"title":"Set up your SIP trunk on Bolna","sidebarTitle":"Set up your trunk","icon":"screwdriver-wrench","iconType":"solid","href":"/sip-trunking/byot-setup"},"expanded":false,"pages":[{"title":"SIP trunk API examples and field reference","sidebarTitle":"API examples \u0026 fields","icon":"code","iconType":"solid","href":"/sip-trunking/api-examples"}]},{"title":"Receive inbound calls via your SIP trunk","sidebarTitle":"Inbound via SIP","icon":"phone-arrow-down-left","iconType":"solid","href":"/sip-trunking/byot-inbound-calls"},{"title":"Custom SIP headers on inbound BYOT calls","sidebarTitle":"Custom SIP headers","icon":"tag","iconType":"solid","href":"/sip-trunking/byot-inbound-headers"},{"title":"Make outbound calls via your SIP trunk","sidebarTitle":"Outbound via SIP","icon":"phone-arrow-up-right","iconType":"solid","href":"/sip-trunking/byot-outbound-calls"}]}]}]},{"group":"Monitor","icon":"chart-line","pages":[{"title":"Monitor your voice agent","sidebarTitle":"Overview","icon":"chart-line","href":"/agents/monitor"},{"group":"Call history \u0026 analytics","icon":"chart-column","root":{"title":"Agent conversations, metrics \u0026 logs","sidebarTitle":"Call history","icon":"clock-rotate-left","iconType":"solid","href":"/agent-setup/call-history"},"expanded":false,"pages":[{"title":"How to read the call analytics dashboard","sidebarTitle":"Call analytics","icon":"chart-pie","iconType":"solid","href":"/agent-setup/call-analytics"}]},{"group":"Latency","icon":"gauge-high","root":{"title":"Latency in real-time voice AI","sidebarTitle":"Responses feel slow","icon":"gauge-high","iconType":"solid","href":"/concepts/latency"},"expanded":false,"pages":[{"title":"Understanding call latency metrics in Bolna voice AI","sidebarTitle":"Latency metrics","icon":"chart-bar","iconType":"solid","href":"/concepts/call-latencies"}]},{"group":"Webhooks \u0026 call status","icon":"webhook","root":{"title":"Receive Bolna voice AI call updates","sidebarTitle":"Results via webhooks","icon":"webhook","iconType":"solid","href":"/post-call/polling-call-status-webhooks"},"expanded":false,"pages":[{"title":"Execution payload reference","sidebarTitle":"Execution payload","icon":"brackets-curly","href":"/post-call/execution-payload"},{"title":"Check Bolna voice AI webhook delivery health","sidebarTitle":"Webhook delivery health","icon":"heart-pulse","href":"/post-call/webhook-delivery-health"},{"title":"Fetch agent executions using APIs","sidebarTitle":"Executions API","icon":"code","href":"/fetch-agent-executions"},{"title":"List of call statuses in Bolna voice AI","sidebarTitle":"Call statuses","icon":"ballot-check","iconType":"solid","href":"/post-call/list-phone-call-status"},{"title":"Termination reasons","sidebarTitle":"Termination reasons","icon":"flag-checkered","iconType":"solid","href":"/post-call/termination-reasons"},{"title":"List of call hangup statuses and codes in Bolna voice AI","sidebarTitle":"Hangup codes","icon":"phone-xmark","iconType":"solid","href":"/post-call/list-phone-call-hangup-status"}]},{"group":"Extractions","icon":"filter","root":{"title":"Using extractions in Bolna dashboard","sidebarTitle":"Extract call data","icon":"list-check","iconType":"solid","href":"/prompting/using-extractions"},"expanded":false,"pages":[{"title":"Testing extractions","sidebarTitle":"Test extractions","icon":"flask","iconType":"solid","href":"/prompting/testing-extractions"},{"title":"Extraction output format and results","sidebarTitle":"Output format \u0026 results","icon":"brackets-curly","iconType":"solid","href":"/prompting/extraction-output"}]}]},{"group":"Go live","icon":"flag-checkered","pages":[{"group":"Launch checklist","icon":"list-check","root":{"title":"Production readiness checklist for voice AI agents","sidebarTitle":"Readiness checklist","icon":"clipboard-check","iconType":"solid","href":"/production/readiness-checklist"},"expanded":false,"pages":[{"title":"Test a voice AI agent before calling real customers","sidebarTitle":"Test before launch","icon":"flask","iconType":"solid","href":"/production/test-before-calling-customers"},{"title":"Control cost per call on Bolna voice AI","sidebarTitle":"Control cost per call","icon":"scissors","iconType":"solid","href":"/production/control-cost-per-call"},{"title":"Handle failures and retries at scale","sidebarTitle":"Failures at scale","icon":"arrows-rotate","iconType":"solid","href":"/production/failures-and-retries-at-scale"}]},{"group":"Troubleshooting","icon":"wrench","root":{"title":"Troubleshoot Bolna voice AI calls","sidebarTitle":"Overview","icon":"screwdriver-wrench","iconType":"solid","href":"/troubleshooting/overview"},"expanded":false,"pages":[{"title":"The agent interrupts or talks over the caller","sidebarTitle":"Agent interrupts users","icon":"hand","iconType":"solid","href":"/troubleshooting/agent-interrupts-users"},{"title":"Agent mishears names, numbers or Indian language words","sidebarTitle":"Agent mishears words","icon":"ear-deaf","iconType":"solid","href":"/troubleshooting/agent-mishears-words"},{"title":"Audio is choppy, robotic, or only one side can hear","sidebarTitle":"Choppy or one-way audio","icon":"volume-xmark","iconType":"solid","href":"/troubleshooting/choppy-or-one-way-audio"},{"title":"Calls fail to connect or drop early","sidebarTitle":"Calls fail or drop","icon":"phone-slash","iconType":"solid","href":"/troubleshooting/calls-fail-or-drop-early"},{"title":"The call transfer did not work","sidebarTitle":"Transfer failed","icon":"phone-arrow-right","iconType":"solid","href":"/troubleshooting/call-transfer-failed"},{"title":"My webhook never arrived","sidebarTitle":"Webhook not received","icon":"webhook","iconType":"solid","href":"/troubleshooting/webhook-not-received"}]}]}]},{"tab":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"API Reference","icon":"terminal","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Developers","icon":"toolbox","pages":[{"title":"Developers","href":"/developer-resources/overview"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/november-2026"}]}]},"basePath":"","title":"Workflow execution webhook - Bolna Docs","buildId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","deploymentId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DBf8HiS-.js","DynamicMarkdown-DcvJmTWC.js","zoom-image-lightbox-Dyw95Qy3.js","lightbox-handle-r17bVUz3.js"]}