{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Callers","description":"Build AI agents that call, text, email, and talk to customers on your website. Guides, Web SDK, and API reference for the Callers platform.","colors":{"primary":"#3655E8","light":"#8EA0FF","dark":"#2A44C4"},"logo":{"light":"https://mintcdn.com/voxiaai/UdPum2goP7yfaYcC/logo/light.svg?fit=max\u0026auto=format\u0026n=UdPum2goP7yfaYcC\u0026q=85\u0026s=b1de758075c8bd929495ea22505d14b8","dark":"https://mintcdn.com/voxiaai/UdPum2goP7yfaYcC/logo/dark.svg?fit=max\u0026auto=format\u0026n=UdPum2goP7yfaYcC\u0026q=85\u0026s=cdb6dcbc265e95b7f15e77b15797cce6","href":"https://docs.callers.ai"},"favicon":"https://mintcdn.com/voxiaai/UdPum2goP7yfaYcC/logo/favicon.svg?fit=max\u0026auto=format\u0026n=UdPum2goP7yfaYcC\u0026q=85\u0026s=4a33273363fdf14d219145aa644b0ff7","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0A0D18"}},"navbar":{"links":[{"href":"https://www.callers.ai/book-a-meeting","label":"Book a demo"},{"href":"https://status.callers.ai","label":"Status"}],"primary":{"type":"button","label":"Open dashboard","href":"https://app.callers.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/callersai","website":"https://www.callers.ai"},"links":[{"header":"Product","items":[{"label":"Website","href":"https://www.callers.ai"},{"label":"Dashboard","href":"https://app.callers.ai"},{"label":"Book a demo","href":"https://www.callers.ai/book-a-meeting"}]},{"header":"Developers","items":[{"label":"API Reference","href":"/api-reference/introduction"},{"label":"Web SDK","href":"/sdk/overview"},{"label":"SDK Playground","href":"https://sdk-playground.callers.dev"}]},{"header":"Company","items":[{"label":"Status","href":"https://status.callers.ai"},{"label":"Trust Center","href":"https://trust.callers.ai"},{"label":"Contact us","href":"mailto:contact@callers.ai"}]}]},"search":{"prompt":"Search docs or ask a question…"},"seo":{"metatags":{"og:site_name":"Callers Docs"},"indexing":"navigable"},"fonts":{"family":"Inter"},"icons":{"library":"fontawesome"},"styling":{"codeblocks":"dark","latex":false},"errors":{"404":{"redirect":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://app.callers.ai"},{"anchor":"Status","icon":"signal","href":"https://status.callers.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"voxiaai","hasAudioNarration":false,"actualSubdomain":"voxiaai","customDomains":["docs.callers.ai"],"gitSource":{"type":"github","owner":"amy-io","repo":"docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae3763acedd4bb159cb2963","collectionId":"4c456f72-e1a9-48a0-a047-fb4eb4d2f1d3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3763acedd4bb159cb2963"},"entitlements":{},"buildId":"6ae3763acedd4bb159cb2963","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Guides","count":77},{"language":"default","tag":"API Reference","count":72},{"language":"default","tag":"Endpoints","count":59},{"language":"default","tag":"Integrations","count":19},{"language":"default","tag":"Web SDK","count":14},{"language":"default","tag":"Get started","count":11},{"language":"default","tag":"Build your agent","count":11},{"language":"default","tag":"Channels","count":11},{"language":"default","tag":"Agents","count":10},{"language":"default","tag":"Contacts","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","href":"/_mintlify/custom/voxiaai/21a11cfc72d9362f/styles.css"}],"page":{"pagePath":"api-reference/webhooks/subscribe-a-webhook","slug":"/api-reference/webhooks/subscribe-a-webhook","pageMetadata":{"title":"Subscribe a Webhook","description":"Add a new webhook to the specified agent.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/webhook/subscribe","href":"/api-reference/webhooks/subscribe-a-webhook","autogeneratedByOpenApi":true},"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: \"Add a new webhook to the specified agent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Subscribe a Webhook","description":"Add a new webhook to the specified agent.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/webhook/subscribe","href":"/api-reference/webhooks/subscribe-a-webhook","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Add a new webhook to the specified agent.","operationId":"CampaignPublicController_subscribeWebhook[0]","parameters":["322aa6d1-1d47-47bf-9857-a8fcfb120a85","c2999b9d-3d48-406b-afca-7beb88e0b904"],"requestBody":"80e94a70-6683-4fac-b353-fa5e58e93bb2","responses":{"200":"b4e20d37-7994-4f71-976d-fa5dac54bc94","400":"0e6fd54b-c2ee-4ce1-b924-5e17144ebfe4","403":"de3dcf8c-c0a1-4a2e-9407-6b63668528d4","404":"e840dda6-7967-496d-bbd6-28ee9eaa0ac9"},"security":["a24d02c6-6f8d-4c27-86b2-a15c2f644c7d"],"summary":"Subscribe a Webhook","tags":["Webhooks"],"method":"post","type":"path","servers":["a446963d-77c5-4f52-b0dc-dcff6ee68cef"],"path":"/agents/{agentId}/webhook/subscribe","baseUrlOptions":["https://api.callers.ai"],"title":"Subscribe a Webhook","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"322aa6d1-1d47-47bf-9857-a8fcfb120a85":{"name":"agentId","required":true,"in":"path","description":"The agent ObjectId as a string.","schema":{"type":"string","isRequired":true,"description":"The agent ObjectId as a string.","uniqueKey":"","typeLabel":"string"}},"c2999b9d-3d48-406b-afca-7beb88e0b904":{"name":"x-sub-organization-id","in":"header","schema":{"type":"string","description":"Optional sub organization ID. Must belong to your main organization API key.","uniqueKey":"","typeLabel":"string"},"description":"Optional sub organization ID. Must belong to your main organization API key."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"name":{"type":"string","maxLength":30,"uniqueKey":"name","typeLabel":"string"},"events":{"type":"array","items":{"type":"string","enum":["POST_PROCESSING_FINISHED:INTERESTED","POST_PROCESSING_FINISHED:NOT_INTERESTED","POST_PROCESSING_FINISHED:CALL_ME_LATER","POST_PROCESSING_FINISHED:WRONG_NUMBER","POST_PROCESSING_FINISHED:DO_NOT_CALL","POST_PROCESSING_FINISHED:VOICE_MAIL","FORWARDED_CALL_FINISHED","FORWARDED","HANG_UP","DIALING","CONNECTED","FAILED","COULD_NOT_CONNECT:NO_ANSWER","COULD_NOT_CONNECT:BUSY","CALL_FINISHED"],"x-enumNames":["POST_PROCESSING_FINISHED_INTERESTED","POST_PROCESSING_FINISHED_NOT_INTERESTED","POST_PROCESSING_FINISHED_CALL_ME_LATER","POST_PROCESSING_FINISHED_WRONG_NUMBER","POST_PROCESSING_FINISHED_DO_NOT_CALL","POST_PROCESSING_FINISHED_VOICE_MAIL","FORWARDED_CALL_FINISHED","FORWARDED","HANG_UP","DIALING","CONNECTED","FAILED","COULD_NOT_CONNECT_NO_ANSWER","COULD_NOT_CONNECT_BUSY","CALL_FINISHED"],"uniqueKey":"events.items.[INDEX]","typeLabel":"enum\u003cstring>"},"default":["POST_PROCESSING_FINISHED:INTERESTED","POST_PROCESSING_FINISHED:NOT_INTERESTED","POST_PROCESSING_FINISHED:CALL_ME_LATER","POST_PROCESSING_FINISHED:WRONG_NUMBER","POST_PROCESSING_FINISHED:DO_NOT_CALL"],"uniqueKey":"events","typeLabel":"enum\u003cstring>[]"},"isAdvanced":{"type":"boolean","default":false,"uniqueKey":"isAdvanced","typeLabel":"boolean"},"advancedWebhook":{"type":"object","properties":{"url":{"type":"string","uniqueKey":"advancedWebhook.url","typeLabel":"string"},"method":{"type":"string","enum":["GET","POST","PUT","DELETE","PATCH"],"x-enumNames":["GET","POST","PUT","DELETE","PATCH"],"uniqueKey":"advancedWebhook.method","typeLabel":"enum\u003cstring>"},"headers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"advancedWebhook.headers.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"advancedWebhook.headers.items.[INDEX].value","typeLabel":"string"}},"required":["name","value"],"uniqueKey":"advancedWebhook.headers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"advancedWebhook.headers","typeLabel":"object[]"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"advancedWebhook.parameters.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"advancedWebhook.parameters.items.[INDEX].value","typeLabel":"string"}},"required":["name","value"],"uniqueKey":"advancedWebhook.parameters.items.[INDEX]","typeLabel":"object"},"uniqueKey":"advancedWebhook.parameters","typeLabel":"object[]"},"body":{"type":"string","default":"","uniqueKey":"advancedWebhook.body","typeLabel":"string"}},"uniqueKey":"advancedWebhook","typeLabel":"object"}},"required":["url"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"url":"\u003cstring>","name":"\u003cstring>","events":["POST_PROCESSING_FINISHED:INTERESTED","POST_PROCESSING_FINISHED:NOT_INTERESTED","POST_PROCESSING_FINISHED:CALL_ME_LATER","POST_PROCESSING_FINISHED:WRONG_NUMBER","POST_PROCESSING_FINISHED:DO_NOT_CALL"],"isAdvanced":false,"advancedWebhook":{"url":"\u003cstring>","headers":[{"name":"\u003cstring>","value":"\u003cstring>"}],"parameters":[{"name":"\u003cstring>","value":"\u003cstring>"}],"body":""}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"b4e20d37-7994-4f71-976d-fa5dac54bc94":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"boolean","uniqueKey":"data","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"success","data":true}}},"exampleType":"generated"}},"exampleType":"generated"},"0e6fd54b-c2ee-4ce1-b924-5e17144ebfe4":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"data":{"type":"array","items":{"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"\u003cstring>","data":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"},"de3dcf8c-c0a1-4a2e-9407-6b63668528d4":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e840dda6-7967-496d-bbd6-28ee9eaa0ac9":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["error"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a24d02c6-6f8d-4c27-86b2-a15c2f644c7d":{"Authorization":{"type":"apiKey","in":"header","name":"Authorization","scopes":[],"schemeName":"Authorization"}}},"servers":{"a446963d-77c5-4f52-b0dc-dcff6ee68cef":{"url":"https://api.callers.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","scopes":[],"schemeName":"Authorization"},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Authorization","name":"Authorization"}],"title":"Authorization"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"voxiaai","siteName":"Callers","title":"Subscribe a Webhook - Callers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T04:16:45.137Z","originalFileLocation":"api-reference/webhooks/subscribe-a-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=\"light\"}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=\"Add a new webhook to the specified agent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Callers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/voxiaai/QQLjIdxYdrMgCmrs/_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/voxiaai/QQLjIdxYdrMgCmrs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/voxiaai/QQLjIdxYdrMgCmrs/_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/voxiaai/QQLjIdxYdrMgCmrs/_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/voxiaai/QQLjIdxYdrMgCmrs/_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/voxiaai/QQLjIdxYdrMgCmrs/_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/voxiaai/QQLjIdxYdrMgCmrs/_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/voxiaai/QQLjIdxYdrMgCmrs/_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/voxiaai/QQLjIdxYdrMgCmrs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Subscribe a Webhook - Callers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a new webhook to the specified agent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Callers Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://voxiaai.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Subscribe+a+Webhook\u0026amp;description=Add+a+new+webhook+to+the+specified+agent.\u0026amp;theme=e7b044c42271a380df08b2cb\u0026amp;signature=28c5d3cbe93f497968b140f6ecc594c1d9d9892e112fbed9b991fa90833aefd2\">\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=\"Subscribe a Webhook - Callers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a new webhook to the specified agent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://voxiaai.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Subscribe+a+Webhook\u0026amp;description=Add+a+new+webhook+to+the+specified+agent.\u0026amp;theme=e7b044c42271a380df08b2cb\u0026amp;signature=28c5d3cbe93f497968b140f6ecc594c1d9d9892e112fbed9b991fa90833aefd2\">\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/voxiaai/QQLjIdxYdrMgCmrs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Callers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3655E8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooks/subscribe-a-webhook.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.callers.ai/#organization\",\"name\":\"Callers\",\"url\":\"https://docs.callers.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/voxiaai/UdPum2goP7yfaYcC/logo/light.svg?fit=max\u0026auto=format\u0026n=UdPum2goP7yfaYcC\u0026q=85\u0026s=b1de758075c8bd929495ea22505d14b8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.callers.ai#website\",\"name\":\"Callers\",\"url\":\"https://docs.callers.ai\",\"publisher\":{\"@id\":\"https://docs.callers.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook#webpage\",\"url\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook\",\"name\":\"Subscribe a Webhook\",\"description\":\"Add a new webhook to the specified agent.\",\"dateModified\":\"2026-10-16T04:16:45.137Z\",\"isPartOf\":{\"@id\":\"https://docs.callers.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.callers.ai/api-reference/agents/get-all-agents-by-organization-id\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://docs.callers.ai/api-reference/webhooks/get-call-webhook-payload-by-agent-id-and-call-id\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Subscribe a Webhook\",\"item\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook#apireference\",\"headline\":\"Subscribe a Webhook\",\"name\":\"Subscribe a Webhook\",\"description\":\"Add a new webhook to the specified agent.\",\"url\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook\",\"mainEntityOfPage\":{\"@id\":\"https://docs.callers.ai/api-reference/webhooks/subscribe-a-webhook#webpage\"},\"dateModified\":\"2026-10-16T04:16:45.137Z\",\"publisher\":{\"@id\":\"https://docs.callers.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.callers.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Callers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Callers","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://app.callers.ai"},{"anchor":"Status","icon":"signal","href":"https://status.callers.ai"}]},"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/documentation/get-started/getting-started-with-callers"}]},{"tab":"Integrations","icon":"grid-2","pages":[{"title":"Integrations","href":"/documentation/integrations/catalog"}]},{"tab":"Web SDK","icon":"code","pages":[{"title":"Web SDK","href":"/sdk/overview"}]},{"tab":"API Reference","icon":"brackets-curly","groups":[{"group":"Get started","pages":[{"title":"API introduction","sidebarTitle":"Introduction","icon":"brackets-curly","href":"/api-reference/introduction"},{"title":"API quickstart","sidebarTitle":"Quickstart","icon":"rocket","href":"/api-reference/quickstart"}]},{"group":"Guides","pages":[{"title":"Launch outbound calls","icon":"phone-arrow-up-right","href":"/api-reference/guides/launch-outbound-calls"},{"title":"Manage agents","icon":"robot","href":"/api-reference/guides/manage-agents"},{"title":"Manage contacts","icon":"address-book","href":"/api-reference/guides/manage-contacts"},{"title":"Contact memory","icon":"brain","href":"/api-reference/guides/contact-memory"},{"title":"Voices and cloning","icon":"waveform-lines","href":"/api-reference/guides/voices-and-cloning"},{"title":"Subaccounts and SIP","icon":"sitemap","href":"/api-reference/guides/subaccounts-and-sip"}]},{"group":"Webhooks","pages":[{"title":"Webhooks overview","sidebarTitle":"Overview","icon":"webhook","href":"/documentation/webhook/webhook-overview"},{"title":"Webhook events","sidebarTitle":"Events","icon":"bolt","href":"/documentation/webhook/webhook-events"},{"title":"Webhook payload","sidebarTitle":"Payload reference","icon":"brackets-curly","href":"/documentation/webhook/webhook-payload"},{"title":"Advanced webhooks","sidebarTitle":"Advanced webhooks","icon":"atom-simple","href":"/documentation/webhook/advanced-webhook"},{"title":"Validating webhook signatures","sidebarTitle":"Validating signatures","icon":"shield-check","href":"/documentation/webhook/validating-webhook-signatures"}]},{"group":"Endpoints","pages":[{"group":"Agents","pages":[{"title":"Get all agents by organization ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents","href":"/api-reference/agents/get-all-agents-by-organization-id"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}","href":"/api-reference/agents/get-an-agent-by-id"},{"title":"Replace agent configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /agents/{agentId}","href":"/api-reference/agents/replace-agent-configuration"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}","href":"/api-reference/agents/delete-an-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{agentId}","href":"/api-reference/agents/update-agent"},{"title":"Start agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/start","href":"/api-reference/agents/start-agent"},{"title":"Stop agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/stop","href":"/api-reference/agents/stop-agent"},{"title":"Update interest criteria","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/update/interestcriteria","href":"/api-reference/agents/update-interest-criteria"},{"title":"Duplicate an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/duplicate","href":"/api-reference/agents/duplicate-an-agent"}]},{"group":"Agent Groups","pages":[{"title":"Get all agent groups for the authenticated organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agent-groups","href":"/api-reference/agent-groups/get-all-agent-groups-for-the-authenticated-organization"},{"title":"Get an agent group by id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agent-groups/{agentGroupId}","href":"/api-reference/agent-groups/get-an-agent-group-by-id"}]},{"group":"Organizations","pages":[{"title":"Get account information","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /organization","href":"/api-reference/organizations/get-account-information"},{"title":"Create sub organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /organization/sub-organization","href":"/api-reference/organizations/create-sub-organization"},{"title":"Delete sub organization by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /organization/{id}","href":"/api-reference/organizations/delete-sub-organization-by-id"},{"title":"Create a SIP carrier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /organization/sip","href":"/api-reference/organizations/create-a-sip-carrier"},{"title":"Get list of SIP connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /organization/sip-list","href":"/api-reference/organizations/get-list-of-sip-connections"},{"title":"Add a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /organization/{sipId}/phone-number","href":"/api-reference/organizations/add-a-phone-number"},{"title":"Set call recording retention period","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /organization/set-recording-retention","href":"/api-reference/organizations/set-call-recording-retention-period"}]},{"group":"Voices","pages":[{"title":"Get all voices for the current organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voices","href":"/api-reference/voices/get-all-voices-for-the-current-organization"},{"title":"Create a new voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voices","href":"/api-reference/voices/create-a-new-voice"},{"title":"Clone a new voice from audio samples","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voices/voice-clone","href":"/api-reference/voices/clone-a-new-voice-from-audio-samples"},{"title":"Update an existing voice by its ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /voices/{id}","href":"/api-reference/voices/update-an-existing-voice-by-its-id"},{"title":"Delete a voice by its ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /voices/{id}","href":"/api-reference/voices/delete-a-voice-by-its-id"},{"title":"Set voice clone file retention","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /voices/clone-files/retention","href":"/api-reference/voices/set-voice-clone-file-retention"}]},{"group":"Calls","pages":[{"title":"Play warm transfer summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /call/{sessionId}/warm-transfer-summary","href":"/api-reference/calls/play-warm-transfer-summary"},{"title":"Get calls by agent ID and contact ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/contacts/{contactId}/calls","href":"/api-reference/calls/get-calls-by-agent-id-and-contact-id"},{"title":"Get all calls by agent ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/calls","href":"/api-reference/calls/get-all-calls-by-agent-id"},{"title":"Get call recording URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/calls/{callId}/recording","href":"/api-reference/calls/get-call-recording-url"},{"title":"Download call PCAP file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/calls/{callId}/pcap","href":"/api-reference/calls/download-call-pcap-file"},{"title":"Update call status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/calls/{callId}/setStatus","href":"/api-reference/calls/update-call-status"}]},{"group":"Contact Memory","pages":[{"title":"Get memories for contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contacts/{contactId}/memories","href":"/api-reference/contact-memory/get-memories-for-contact"},{"title":"Create memory for contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contacts/{contactId}/memories","href":"/api-reference/contact-memory/create-memory-for-contact"},{"title":"Delete all memories for contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contacts/{contactId}/memories","href":"/api-reference/contact-memory/delete-all-memories-for-contact"},{"title":"Delete memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /memories/{memoryId}","href":"/api-reference/contact-memory/delete-memory"},{"title":"Update memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /memories/{memoryId}","href":"/api-reference/contact-memory/update-memory"},{"title":"Get memories for campaign contact by phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/contacts/{phoneNumber}/memories","href":"/api-reference/contact-memory/get-memories-for-campaign-contact-by-phone-number"},{"title":"Create memory for campaign contact by phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/contacts/{phoneNumber}/memories","href":"/api-reference/contact-memory/create-memory-for-campaign-contact-by-phone-number"}]},{"group":"Background Noises","pages":[{"title":"List background sounds","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /background-noise","href":"/api-reference/background-noises/list-background-sounds"},{"title":"Upload a background sound","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /background-noise","href":"/api-reference/background-noises/upload-a-background-sound"},{"title":"Rename a background sound","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /background-noise/{id}","href":"/api-reference/background-noises/rename-a-background-sound"},{"title":"Delete a background sound","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /background-noise/{id}","href":"/api-reference/background-noises/delete-a-background-sound"}]},{"group":"Contacts","pages":[{"title":"Get all contacts by agent ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/contacts","href":"/api-reference/contacts/get-all-contacts-by-agent-id"},{"title":"Create a contact for an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/contacts","href":"/api-reference/contacts/create-a-contact-for-an-agent"},{"title":"Archive all agent contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/contacts","href":"/api-reference/contacts/archive-all-agent-contacts"},{"title":"Create contacts for an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/contacts/bulk","href":"/api-reference/contacts/create-contacts-for-an-agent"},{"title":"Archive contacts by contact IDs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/contacts/bulk","href":"/api-reference/contacts/archive-contacts-by-contact-ids"},{"title":"Archive contacts by contact phone numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/contacts/phone-number/bulk","href":"/api-reference/contacts/archive-contacts-by-contact-phone-numbers"},{"title":"Get a contact by ID.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/contacts/{contactId}","href":"/api-reference/contacts/get-a-contact-by-id"},{"title":"Archive contact by contact ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/contacts/{contactId}","href":"/api-reference/contacts/archive-contact-by-contact-id"},{"title":"Archive a contact by phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/contacts/phoneNumber/{phoneNumber}","href":"/api-reference/contacts/archive-a-contact-by-phone-number"},{"title":"Get contacts report by status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/report","href":"/api-reference/contacts/get-contacts-report-by-status"}]},{"group":"Webhooks","pages":[{"title":"Get call webhook payload by agent ID and call ID","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/calls/{callId}/webhook-payload","href":"/api-reference/webhooks/get-call-webhook-payload-by-agent-id-and-call-id"},{"title":"Subscribe a Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/webhook/subscribe","href":"/api-reference/webhooks/subscribe-a-webhook"}]},{"group":"Vocabulary","pages":[{"title":"Get vocabulary entries","description":"Returns all STT vocabulary entries for the agent.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/vocabulary","href":"/api-reference/vocabulary/get-vocabulary-entries"},{"title":"Update existing vocabulary entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /agents/{agentId}/vocabulary","href":"/api-reference/vocabulary/update-existing-vocabulary-entries"},{"title":"Upload vocabulary entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/vocabulary","href":"/api-reference/vocabulary/upload-vocabulary-entries"},{"title":"Clear all vocabulary entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/vocabulary","href":"/api-reference/vocabulary/clear-all-vocabulary-entries"},{"title":"Remove specific vocabulary entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/vocabulary/remove","href":"/api-reference/vocabulary/remove-specific-vocabulary-entries"}]}]}]},{"tab":"Changelog","icon":"sparkles","pages":[{"title":"Changelog","href":"/documentation/resources/changelog"}]}]},"basePath":"","title":"Subscribe a Webhook - Callers","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}