Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.
If your team is manually dialing leads one by one, or your CRM needs to kick off a call the moment a lead comes in, this is how you automate that with Bananaflow.Say you’ve got leads or accounts sitting in a CRM or a Google Sheet. Each row has details like customer name, company name, amount due. The API Trigger node lets you take that row of data and turn it into a personalized call, automatically.
Step 1: Add the node
Click Add node and add an API Trigger node, the topmost option in the list. This node starts the call and passes your data into the agent as initial_context.That’s the part that matters: instead of the agent asking basic setup questions on the call, like “what’s your name” or “how much do you owe”, it already knows. in this example, the opening node greets the caller with {{debtor_name}}, and the next node references {{client_name}} and {{debt_amount}}. None of that is hardcoded into the agent. It all comes from the API call.
Every node has a docs link in the top right corner. If you get stuck or want to go deeper on any node type, open the docs straight from there.
Go to the developer portal and generate an API key. You’ll need it in the request header.
Step 3: Find your trigger URL
Open the API Trigger node. You’ll see two URLs:
Test URL runs your latest draft.
Production URL runs your published agent.
If you change the agent and want the production URL to reflect it, publish first, otherwise production keeps running the older version. While you’re still testing, use the test URL.
Step 4: Send the request
Trigger the call from Postman, or wherever your backend lives. In the body, send phone_number and initial_context:
The body can come from your CRM, a Google Sheet, or your own backend, wherever that row of data lives.
What you get
Send the request, and the call is queued and goes out as soon as a line is free; the answer gives you the call’s ID right away, and you can follow the call through its statuses. Because the agent already had the context before the call started, the conversation is short and specific from the first line: “Hi, this is Alex from Apex Recovery Solutions. Am I speaking with Rushil? I’m calling about your Quick Credit account with an outstanding balance of $3,500.” No setup questions, straight to the point.
Next Steps
Get that data back automatically: the next step is Sync Data using Webhook, which takes whatever the agent learns on the call and sends it back to your system the moment it ends.
No phone number connected yet? See Connect with Telephony first, outbound calls need a telephony provider attached.
Full endpoint reference: error codes, response shape, and choosing a specific telephony configuration are in API Trigger.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bananaflow AI","colors":{"primary":"#005FF2","light":"#47A8FF","dark":"#006BFF"},"logo":{"light":"https://mintcdn.com/bananaflow/QToRpsLnU_h_dyEA/logo/light.svg?fit=max\u0026auto=format\u0026n=QToRpsLnU_h_dyEA\u0026q=85\u0026s=16eaca83b45b3d48fab505183cc83d18","dark":"https://mintcdn.com/bananaflow/QToRpsLnU_h_dyEA/logo/dark.svg?fit=max\u0026auto=format\u0026n=QToRpsLnU_h_dyEA\u0026q=85\u0026s=c70540e1512228f948877331660736fa","href":"https://docs.bananaflow.ai"},"favicon":"https://mintcdn.com/bananaflow/QToRpsLnU_h_dyEA/favicon.ico?fit=max\u0026auto=format\u0026n=QToRpsLnU_h_dyEA\u0026q=85\u0026s=998044cc570de2b8c619d278cbfb334b","api":{"openapi":"api-reference/openapi.json"},"background":{"color":{"light":"#FAFAFA","dark":"#000000"}},"navbar":{"links":[{"href":"mailto:hello@bananaflow.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.bananaflow.ai"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/bananaflow"}},"search":{"prompt":"Search for Tools, Webhooks, Telephony, etc..."},"fonts":{"family":"Geist"},"banner":{"content":"🎉 **New: MCP Server** – Connect Claude, Cursor, and other AI assistants to your Bananaflow workspace. [Set it up →](/integrations/mcp)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bananaflow","hasAudioNarration":false,"actualSubdomain":"bananaflow","customDomains":["docs.bananaflow.ai"],"gitSource":{"type":"github","owner":"timetracker-developer","repo":"bananaflow-web","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6b0046b9cba301bc987935f0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Guides","count":63},{"language":"default","tag":"API Reference","count":51},{"language":"default","tag":"Resources","count":48},{"language":"default","tag":"Voice Agent Builder","count":21},{"language":"default","tag":"Telephony Configurations","count":14},{"language":"default","tag":"Telephony","count":14},{"language":"default","tag":"Agents","count":12},{"language":"default","tag":"Campaigns","count":11},{"language":"default","tag":"Runs","count":9},{"language":"default","tag":"Nodes","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":":root{--bf-border: #ebebeb;--bf-border-hover: #c9c9c9}html.dark{--bf-border: #2e2e2e;--bf-border-hover: #454545}[data-search-button],.search-button,[aria-label*=\"search\"],[placeholder*=\"Search\"],button[data-testid*=\"search\"],.mintlify-search,.DocSearch-Button{border:1px solid var(--bf-border)!important;border-radius:6px!important;box-shadow:none!important;transition:border-color 0.15s ease!important}[data-search-button]:hover,.search-button:hover,[aria-label*=\"search\"]:hover,[placeholder*=\"Search\"]:hover,button[data-testid*=\"search\"]:hover,.mintlify-search:hover,.DocSearch-Button:hover{border-color:var(--bf-border-hover)!important}"}]}
{"page":{"pagePath":"getting-started/trigger-calls-from-your-backend","slug":"/getting-started/trigger-calls-from-your-backend","pageMetadata":{"title":"Trigger Calls using API","description":"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.","href":"/getting-started/trigger-calls-from-your-backend"},"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: \"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.\"\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`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`If your team is manually dialing leads one by one, or your CRM needs to kick off a call the moment a lead comes in, this is how you automate that with Bananaflow.`}),`\n`,_jsxs(_components.p,{children:[`Say you’ve got leads or accounts sitting in a CRM or a Google Sheet. Each row has details like customer name, company name, amount due. The `,_jsx(_components.strong,{children:`API Trigger`}),` node lets you take that row of data and turn it into a personalized call, automatically.`]}),`\n`,_jsx(Heading,{level:`2`,id:`step-1-add-the-node`,children:`Step 1: Add the node`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add node`}),` and add an `,_jsx(_components.strong,{children:`API Trigger`}),` node, the topmost option in the list. This node starts the call and passes your data into the agent as `,_jsx(_components.code,{children:`initial_context`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`That’s the part that matters: instead of the agent asking basic setup questions on the call, like “what’s your name” or “how much do you owe”, it already knows. in this example, the opening node greets the caller with `,_jsx(_components.code,{children:`{{debtor_name}}`}),`, and the next node references `,_jsx(_components.code,{children:`{{client_name}}`}),` and `,_jsx(_components.code,{children:`{{debt_amount}}`}),`. None of that is hardcoded into the agent. It all comes from the API call.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Every node has a docs link in the top right corner. If you get stuck or want to go deeper on any node type, open the docs straight from there.`})}),`\n`,_jsx(Heading,{level:`2`,id:`step-2-check-the-prerequisites`,children:`Step 2: Check the prerequisites`}),`\n`,_jsx(_components.p,{children:`Before you trigger anything:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/getting-started/connect-telephony`,children:`Connect with Telephony`}),` for outbound calls.`]}),`\n`,_jsx(_components.li,{children:`Go to the developer portal and generate an API key. You’ll need it in the request header.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`step-3-find-your-trigger-url`,children:`Step 3: Find your trigger URL`}),`\n`,_jsx(_components.p,{children:`Open the API Trigger node. You’ll see two URLs:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Test URL`}),` runs your latest draft.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Production URL`}),` runs your published agent.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`If you change the agent and want the production URL to reflect it, publish first, otherwise production keeps running the older version. While you’re still testing, use the test URL.`}),`\n`,_jsx(Heading,{level:`2`,id:`step-4-send-the-request`,children:`Step 4: Send the request`}),`\n`,_jsxs(_components.p,{children:[`Trigger the call from Postman, or wherever your backend lives. In the body, send `,_jsx(_components.code,{children:`phone_number`}),` and `,_jsx(_components.code,{children:`initial_context`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,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:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://app.bananaflow.ai/api/v1/public/agent/test/{uuid}`}),_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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: bnf_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:` -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:` \"phone_number\": \"+14155550100\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"initial_context\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"debtor_name\": \"Rushil\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"client_name\": \"Quick Credit\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"debt_amount\": \"3500\"`})}),`\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`,_jsx(_components.p,{children:`The body can come from your CRM, a Google Sheet, or your own backend, wherever that row of data lives.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-get`,children:`What you get`}),`\n`,_jsxs(_components.p,{children:[`Send the request, and the call is queued and goes out as soon as a line is free; the answer gives you the call’s ID right away, and you can follow the call through its `,_jsx(_components.a,{href:`/voice-agent/api-trigger#call-statuses`,children:`statuses`}),`. Because the agent already had the context before the call started, the conversation is short and specific from the first line: `,_jsx(_components.em,{children:`“Hi, this is Alex from Apex Recovery Solutions. Am I speaking with Rushil? I’m calling about your Quick Credit account with an outstanding balance of $3,500.”`}),` No setup questions, straight to the point.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Get that data back automatically`}),`: the next step is `,_jsx(_components.a,{href:`/getting-started/send-call-data-with-webhooks`,children:`Sync Data using Webhook`}),`, which takes whatever the agent learns on the call and sends it back to your system the moment it ends.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No phone number connected yet?`}),` See `,_jsx(_components.a,{href:`/getting-started/connect-telephony`,children:`Connect with Telephony`}),` first, outbound calls need a telephony provider attached.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Full endpoint reference`}),`: error codes, response shape, and choosing a specific telephony configuration are in `,_jsx(_components.a,{href:`/voice-agent/api-trigger`,children:`API Trigger`}),`.`]}),`\n`]})]})}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":{"config":{},"pageMetadata":{"title":"Trigger Calls using API","description":"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.","href":"/getting-started/trigger-calls-from-your-backend"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Step 1: Add the node","slug":"step-1-add-the-node","depth":2,"children":[]},{"title":"Step 2: Check the prerequisites","slug":"step-2-check-the-prerequisites","depth":2,"children":[]},{"title":"Step 3: Find your trigger URL","slug":"step-3-find-your-trigger-url","depth":2,"children":[]},{"title":"Step 4: Send the request","slug":"step-4-send-the-request","depth":2,"children":[]},{"title":"What you get","slug":"what-you-get","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/bananaflow/52439f9c58f0d520/custom.js"],"subdomain":"bananaflow","siteName":"Bananaflow AI","title":"Trigger Calls using API - Bananaflow AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T05:28:45.429Z","originalFileLocation":"getting-started/trigger-calls-from-your-backend.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=\"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bananaflow AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Trigger Calls using API - Bananaflow AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bananaflow AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bananaflow.mintlify.site/_mintlify/api/og/v2?division=Build+your+First+Agent\u0026amp;title=Trigger+Calls+using+API\u0026amp;description=Kick+off+a+call+the+moment+a+lead+lands+in+your+CRM+or+spreadsheet%2C+no+manual+dialing.\u0026amp;theme=8b9525ec21bc986a63e24cda\u0026amp;signature=00feabce6bf15263c1e9a0805182958025ca62756b991155fb00d7a691377001\">\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=\"Trigger Calls using API - Bananaflow AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bananaflow.mintlify.site/_mintlify/api/og/v2?division=Build+your+First+Agent\u0026amp;title=Trigger+Calls+using+API\u0026amp;description=Kick+off+a+call+the+moment+a+lead+lands+in+your+CRM+or+spreadsheet%2C+no+manual+dialing.\u0026amp;theme=8b9525ec21bc986a63e24cda\u0026amp;signature=00feabce6bf15263c1e9a0805182958025ca62756b991155fb00d7a691377001\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bananaflow/rHG5sOcjOga6o5Go/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bananaflow AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#005FF2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started/trigger-calls-from-your-backend.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bananaflow.ai/#organization\",\"name\":\"Bananaflow AI\",\"url\":\"https://docs.bananaflow.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bananaflow/QToRpsLnU_h_dyEA/logo/light.svg?fit=max\u0026auto=format\u0026n=QToRpsLnU_h_dyEA\u0026q=85\u0026s=16eaca83b45b3d48fab505183cc83d18\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bananaflow.ai#website\",\"name\":\"Bananaflow AI\",\"url\":\"https://docs.bananaflow.ai\",\"publisher\":{\"@id\":\"https://docs.bananaflow.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend#webpage\",\"url\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend\",\"name\":\"Trigger Calls using API\",\"description\":\"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.\",\"dateModified\":\"2026-11-03T05:28:45.429Z\",\"isPartOf\":{\"@id\":\"https://docs.bananaflow.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Build your First Agent\",\"item\":\"https://docs.bananaflow.ai/getting-started/first-agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Trigger Calls using API\",\"item\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend#article\",\"headline\":\"Trigger Calls using API\",\"name\":\"Trigger Calls using API\",\"description\":\"Kick off a call the moment a lead lands in your CRM or spreadsheet, no manual dialing.\",\"url\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bananaflow.ai/getting-started/trigger-calls-from-your-backend#webpage\"},\"dateModified\":\"2026-11-03T05:28:45.429Z\",\"publisher\":{\"@id\":\"https://docs.bananaflow.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bananaflow.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bananaflow AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bananaflow AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/getting-started/trigger-calls-from-your-backend.md","siteName":"Bananaflow AI","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","groups":[{"group":"Getting started","pages":[{"group":"Introduction","pages":[{"title":"Introduction","href":"/getting-started"}]}]},{"group":"Build your First Agent","pages":[{"title":"Your First Agent in 5 Minutes","description":"Build and talk to a working voice agent in five minutes using Web Calls – no telephony setup required.","href":"/getting-started/first-agent"},{"title":"Trigger Calls using API","href":"/getting-started/trigger-calls-from-your-backend"},{"title":"Sync Data using Webhook","description":"Get everything Bananaflow learned during the call back into your system the moment it ends.","href":"/getting-started/send-call-data-with-webhooks"},{"title":"Connect with Telephony","href":"/getting-started/connect-telephony"},{"title":"Use External Tools, Knowledge","href":"/getting-started/add-tools-and-knowledge-base"}]},{"group":"Core Concepts","pages":[{"title":"How Bananaflow Works","href":"/core-concepts/how-bananaflow-works"},{"title":"Workflows \u0026 Agents","href":"/core-concepts/workflows-and-agents"},{"title":"Calls \u0026 Runs","href":"/core-concepts/calls-and-runs"},{"title":"Context \u0026 Variables","href":"/core-concepts/context-and-variables"},{"title":"Campaigns","sidebarTitle":"Campaigns (Bulk Outbound Calls)","href":"/core-concepts/campaigns"}]},{"group":"Billing","pages":[{"title":"Billing Overview","href":"/billing/overview"},{"title":"Credit and Recharge","href":"/billing/credit-and-recharge"},{"title":"What You Are Charged For","href":"/billing/charges-and-low-balance"}]},{"group":"Configurations","pages":[{"title":"Voice","href":"/configurations/voice"},{"title":"API Keys","href":"/configurations/api-keys"},{"title":"Agent UUID","href":"/configurations/agent-uuid"},{"title":"Interruptions and Turn-Taking","href":"/configurations/interruption"},{"title":"Unfinished Sentences","href":"/configurations/unfinished-sentences"},{"title":"Tracing","href":"/configurations/tracing"},{"title":"Call events","href":"/configurations/call-events"}]},{"group":"Voice Agent Builder","pages":[{"title":"Voice Agent Builder","href":"/voice-agent/introduction"},{"title":"Editing a Workflow","href":"/voice-agent/editing-a-workflow"},{"title":"Pre-recorded Audio","href":"/voice-agent/pre-recorded-audio"},{"title":"Template Variables","href":"/voice-agent/template-variables"},{"title":"Pre-Call Data Fetch","href":"/voice-agent/pre-call-data-fetch"},{"group":"Tools","pages":[{"title":"Tools","href":"/voice-agent/tools/introduction"},{"group":"Built-in Tools","pages":[{"title":"Call Transfer","href":"/voice-agent/tools/call-transfer"},{"title":"Transfer to Agent","href":"/voice-agent/tools/transfer-agent"},{"title":"End Call","href":"/voice-agent/tools/end-call"}]},{"group":"Custom Tools","pages":[{"title":"HTTP API","href":"/voice-agent/tools/http-api"},{"title":"MCP Tool","href":"/voice-agent/tools/mcp-tool"}]}]},{"title":"Knowledge Base","href":"/voice-agent/knowledge-base"},{"group":"Nodes","pages":[{"title":"Start Call","href":"/voice-agent/start-call"},{"title":"End Call","href":"/voice-agent/end-call"},{"title":"Agent Node","href":"/voice-agent/agent"},{"title":"Global Node","href":"/voice-agent/global"},{"title":"QA","href":"/voice-agent/qa"},{"title":"Evals","href":"/voice-agent/evals"},{"title":"API Trigger","href":"/voice-agent/api-trigger"},{"title":"Webhook","href":"/voice-agent/webhook"}]},{"title":"Add to Website","tag":"NEW","href":"/voice-agent/add-to-website"}]},{"group":"Telephony","pages":[{"title":"Telephony Integration","href":"/integrations/telephony/overview"},{"title":"Inbound Calling","href":"/integrations/telephony/inbound"},{"title":"Twilio Integration","href":"/integrations/telephony/twilio"},{"title":"Vonage Integration","href":"/integrations/telephony/vonage"},{"title":"Plivo Integration","href":"/integrations/telephony/plivo"},{"title":"Telnyx Integration","href":"/integrations/telephony/telnyx"},{"title":"Cloudonix Integration","href":"/integrations/telephony/cloudonix"},{"title":"Exotel Integration","href":"/integrations/telephony/exotel"},{"title":"Vobiz Integration","href":"/integrations/telephony/vobiz"},{"title":"WhatsApp Integration","href":"/integrations/telephony/whatsapp"},{"title":"Asterisk ARI Integration","href":"/integrations/telephony/asterisk-ari"},{"title":"VICIdial Integration","href":"/integrations/telephony/vicidial"},{"title":"Webhooks and Callbacks","href":"/integrations/telephony/webhooks"},{"title":"Agent Stream","href":"/integrations/telephony/agent-stream"}]},{"group":"Integrations","tag":"NEW","pages":[{"title":"MCP Server","href":"/integrations/mcp"},{"title":"Tuner Integration","href":"/integrations/tuner"},{"title":"Paygent Integration","href":"/integrations/paygent"},{"title":"Noveum Integration","href":"/integrations/noveum"}]}]},{"tab":"Developer","icon":"code","pages":[{"title":"Developer","href":"/developer/workflow-schema"}]},{"tab":"API Reference","icon":"square-terminal","pages":[{"title":"API Reference","href":"/api-reference/api-keys"}]}]},"basePath":"","title":"Trigger Calls using API - Bananaflow AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}