Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues
Testing Your Tools
Use the built-in test runner on the Interactly platform to verify your tool is configured correctly before going live.
1
Open the Test Panel
Navigate to your tool and click the Test Tool tab to open the testing interface.
Click to start tool testing
2
Review Tool Details & Fill Parameters
You will see a detailed view of your configured tool. Any parameters defined for the tool are listed on the left side — fill in the required values before running the test.
Tool details with parameter input fields on the left
3
Run the Test
Once all parameters are filled in, click Run Test to send a request to your server endpoint.
Run test button
4
Review the Response
Check the response returned by your endpoint.
Success Response
A correctly configured tool will return a 200 status with the expected payload from your server.
Successful tool response
Wrong Method Error
If your endpoint does not accept the HTTP method being used (e.g., sending GET instead of POST), you will see a method-not-allowed error like below.
Wrong HTTP method configuration
Fix: Go back to your tool’s server configuration and ensure the correct HTTP method (e.g., POST) is selected.
Wrong Authorization Header
A common mistake is using authorisation instead of authorization in the header key. This causes authentication to fail.
Wrong authorization header spelling
Fix: In the Headers section of your tool, ensure the key is spelled authorization (not authorisation).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Interactly API","colors":{"primary":"#1E6EFF","light":"#1E6EFF","dark":"#1E6EFF"},"logo":{"light":"https://mintcdn.com/interactly/ptkIknAxuLhZ0nuk/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=ptkIknAxuLhZ0nuk\u0026q=85\u0026s=1699fd93557b1619c6e3f1d2178e1a98","dark":"https://mintcdn.com/interactly/ptkIknAxuLhZ0nuk/logo/logo_dark.svg?fit=max\u0026auto=format\u0026n=ptkIknAxuLhZ0nuk\u0026q=85\u0026s=3288bfdbdb0359548e380ee02eb228a8"},"favicon":"https://mintcdn.com/interactly/ptkIknAxuLhZ0nuk/logo/favicon.png?fit=max\u0026auto=format\u0026n=ptkIknAxuLhZ0nuk\u0026q=85\u0026s=ba9a8d60e41a25f95e82b23f717a8f7b","api":{"playground":{"display":"interactive","proxy":false}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://interactly.ai","label":"Website"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.interactly.ai"}},"footer":{"socials":{}},"seo":{"indexing":"all"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"interactly","hasAudioNarration":false,"actualSubdomain":"interactly","customDomains":["docs.interactly.ai"],"gitSource":{"type":"github","owner":"interactly","repo":"docs","deployBranch":"prod","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae9236e416fcb78afb0a1be:success","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"API Reference","count":217},{"language":"default","tag":"Workflows","count":140},{"language":"default","tag":"Campaigns","count":50},{"language":"default","tag":"APIs","count":38},{"language":"default","tag":"Documentation","count":33},{"language":"default","tag":"SMS","count":29},{"language":"default","tag":"Campaigns Calls","count":18},{"language":"default","tag":"Tools","count":15},{"language":"default","tag":"Simulations","count":13},{"language":"default","tag":"Contacts","count":12}]},"assistantConfig":{},"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":"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":false},"customCss":[],"page":{"pagePath":"assistant-tools/testing-tools","slug":"/assistant-tools/testing-tools","pageMetadata":{"title":"Testing Tools","subtitle":"Verify your tool configuration before going live","slug":"assistant-tools/testing-tools","description":"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues","href":"/assistant-tools/testing-tools"},"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: \"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues\"\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={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`testing-your-tools`,children:`Testing Your Tools`}),`\n`,_jsx(_components.p,{children:`Use the built-in test runner on the Interactly platform to verify your tool is configured correctly before going live.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the Test Panel`,children:[_jsxs(_components.p,{children:[`Navigate to your tool and click the `,_jsx(_components.strong,{children:`Test Tool`}),` tab to open the testing interface.`]}),_jsx(Frame,{caption:`Click to start tool testing`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/test-tool-click.png?fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=6b0ee364b5d6d5876d9a934686259b0d`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1496`,height:`1496`,\"data-path\":`images/assistant-tools/test-tool-click.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/test-tool-click.png?w=280\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=f4265deba76281cc0866b231354996d7 280w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/test-tool-click.png?w=560\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=69d4ce24f8314686d26d06b9ce8d1844 560w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/test-tool-click.png?w=840\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=f8aa5d542380fbe2df259c0840bdd960 840w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/test-tool-click.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=2a4c89fd7cb0b37a324f8a8a3ee9cf57 1100w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/test-tool-click.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=1b62033c1a1ac6c9e8238bb78b5720b9 1650w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/test-tool-click.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=cd58b421538597324064f86c9cdd80f2 2500w`})})]}),_jsxs(Step,{title:`Review Tool Details \u0026 Fill Parameters`,children:[_jsx(_components.p,{children:`You will see a detailed view of your configured tool. Any parameters defined for the tool are listed on the left side — fill in the required values before running the test.`}),_jsx(Frame,{caption:`Tool details with parameter input fields on the left`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/view-tool-and-give-params-value.png?fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=b557634416d848ffb787d35e411865fa`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1496`,height:`1496`,\"data-path\":`images/assistant-tools/view-tool-and-give-params-value.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/view-tool-and-give-params-value.png?w=280\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=9accbd3c5ca1f903016104db3b3dc231 280w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/view-tool-and-give-params-value.png?w=560\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=f3bf00e1f76760dd73e29a3ea4457c1e 560w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/view-tool-and-give-params-value.png?w=840\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=a762101c94134e8d0c4adf846a548d49 840w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/view-tool-and-give-params-value.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=ebf87424ef8182bcc5cb755ef7cc7309 1100w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/view-tool-and-give-params-value.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=ccc04e6581a6ac943d93afc95b538d8b 1650w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/view-tool-and-give-params-value.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=554fc47406459102b1a34d18ee436653 2500w`})})]}),_jsxs(Step,{title:`Run the Test`,children:[_jsxs(_components.p,{children:[`Once all parameters are filled in, click `,_jsx(_components.strong,{children:`Run Test`}),` to send a request to your server endpoint.`]}),_jsx(Frame,{caption:`Run test button`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/run-test.png?fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=975026f162bf24fbb2fbeeec1c010a11`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1496`,height:`1496`,\"data-path\":`images/assistant-tools/run-test.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/run-test.png?w=280\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=c3232773db76d1e7c5bfee7632d22439 280w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/run-test.png?w=560\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=43e13e3bc92a45d4ccc376168b3d3ecf 560w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/run-test.png?w=840\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=ea7b117b2358530fd980daa8690ecc85 840w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/run-test.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=ff2e24d24da55411da28ea357fd6d0f0 1100w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/run-test.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=7ce9eda1ec4cb67f35ca5b924ace0965 1650w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/run-test.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=72b8a4d0949c01ed0b4326229ea77337 2500w`})})]}),_jsxs(Step,{title:`Review the Response`,children:[_jsx(_components.p,{children:`Check the response returned by your endpoint.`}),_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Success Response`,icon:`circle-check`,id:`success-response`,children:[_jsxs(_components.p,{children:[`A correctly configured tool will return a `,_jsx(_components.code,{children:`200`}),` status with the expected payload from your server.`]}),_jsx(Frame,{caption:`Successful tool response`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/tool-success-response.png?fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=ad008bb953d49b306fc7cc90cb3ff3e3`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1496`,height:`1496`,\"data-path\":`images/assistant-tools/tool-success-response.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/tool-success-response.png?w=280\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=e452304837cdc2af255ec5beac764361 280w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/tool-success-response.png?w=560\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=26a0bfcb218debf3e8f9a68d99552927 560w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/tool-success-response.png?w=840\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=c9f1c6420e94dc299417b11ca1b0de40 840w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/tool-success-response.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=7c0cbe919085304c492072fe4ece9d1a 1100w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/tool-success-response.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=a47f8a30f2945c7830875c78a3b35c28 1650w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/tool-success-response.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=c0bde9fb1dc870800b1ebe6e5d4b1138 2500w`})})]}),_jsxs(Accordion,{title:`Wrong Method Error`,icon:`triangle-exclamation`,id:`wrong-method-error`,children:[_jsxs(_components.p,{children:[`If your endpoint does not accept the HTTP method being used (e.g., sending `,_jsx(_components.code,{children:`GET`}),` instead of `,_jsx(_components.code,{children:`POST`}),`), you will see a method-not-allowed error like below.`]}),_jsx(Frame,{caption:`Wrong HTTP method configuration`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result.png?fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=1085b4f6ebaa20fe5c994e84dc2bb8ad`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1496`,height:`1496`,\"data-path\":`images/assistant-tools/wrong-configuration-result.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result.png?w=280\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=e2991836ab98f2b2e5ce3daa1cffe41c 280w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result.png?w=560\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=779a9b199bc2a3418815ab21f1fd7170 560w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result.png?w=840\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=d55af49d093f87c3ceecc3ab5f6d9999 840w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=b5eedc40960ee4a0803d023b33b2e330 1100w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=1e4d5b588c0c7ba89c7923865cff2486 1650w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=5cab4e95671b3744e0809d9f01a71f55 2500w`})}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix:`}),` Go back to your tool’s server configuration and ensure the correct HTTP method (e.g., `,_jsx(_components.code,{children:`POST`}),`) is selected.`]})]}),_jsxs(Accordion,{title:`Wrong Authorization Header`,icon:`lock-open`,id:`wrong-authorization-header`,children:[_jsxs(_components.p,{children:[`A common mistake is using `,_jsx(_components.code,{children:`authorisation`}),` instead of `,_jsx(_components.code,{children:`authorization`}),` in the header key. This causes authentication to fail.`]}),_jsx(Frame,{caption:`Wrong authorization header spelling`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result-2.png?fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=f66cce621f3a7c7a3effa0379305903a`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1496`,height:`1496`,\"data-path\":`images/assistant-tools/wrong-configuration-result-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=086350f6e9d9385dd07da6d6b951f091 280w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=6d917db4e2f09b24a91aac7e7e985cef 560w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=becb308a977e842c737f870950facad9 840w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=7d7a607757d94077dfca6d5ca3de1725 1100w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=8417957874a0de24abf3fe9724df4a54 1650w, https://mintcdn.com/interactly/cKT5s1zM3GkxWIMc/images/assistant-tools/wrong-configuration-result-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cKT5s1zM3GkxWIMc\u0026q=85\u0026s=6d2b8384afb823deb8f65882200159c2 2500w`})}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix:`}),` In the `,_jsx(_components.strong,{children:`Headers`}),` section of your tool, ensure the key is spelled `,_jsx(_components.code,{children:`authorization`}),` (not `,_jsx(_components.code,{children:`authorisation`}),`).`]})]})]})]})]})]})}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":"Testing Tools","subtitle":"Verify your tool configuration before going live","slug":"assistant-tools/testing-tools","description":"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues","href":"/assistant-tools/testing-tools"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Testing Your Tools","slug":"testing-your-tools","depth":1,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"interactly","siteName":"Interactly API","title":"Testing Tools - Interactly API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-13T10:39:41.371Z","originalFileLocation":"assistant-tools/testing-tools.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=\"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues\">\u003cmeta data-mint-head name=\"application-name\" content=\"Interactly API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/interactly/g50ZSunBarE7sRBb/_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/interactly/g50ZSunBarE7sRBb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/interactly/g50ZSunBarE7sRBb/_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/interactly/g50ZSunBarE7sRBb/_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/interactly/g50ZSunBarE7sRBb/_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/interactly/g50ZSunBarE7sRBb/_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/interactly/g50ZSunBarE7sRBb/_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/interactly/g50ZSunBarE7sRBb/_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/interactly/g50ZSunBarE7sRBb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Testing Tools - Interactly API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Interactly API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.interactly.ai/assistant-tools/testing-tools\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://interactly.mintlify.site/_mintlify/api/og/v2?division=Assistant+Tools\u0026amp;title=Testing+Tools\u0026amp;description=Use+the+built-in+test+runner+on+the+Interactly+platform+to+test+your+custom+tool+integrations+and+troubleshoot+configuration+issues\u0026amp;theme=d931c30529a0b21b8d46d56c\u0026amp;signature=0a211d08b5e5dfff72706cb720d5c634f42363e1fd5b4eea8bc3b92417f31d74\">\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=\"Testing Tools - Interactly API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://interactly.mintlify.site/_mintlify/api/og/v2?division=Assistant+Tools\u0026amp;title=Testing+Tools\u0026amp;description=Use+the+built-in+test+runner+on+the+Interactly+platform+to+test+your+custom+tool+integrations+and+troubleshoot+configuration+issues\u0026amp;theme=d931c30529a0b21b8d46d56c\u0026amp;signature=0a211d08b5e5dfff72706cb720d5c634f42363e1fd5b4eea8bc3b92417f31d74\">\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/interactly/g50ZSunBarE7sRBb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Interactly API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E6EFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.interactly.ai/assistant-tools/testing-tools\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/assistant-tools/testing-tools.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.interactly.ai/#organization\",\"name\":\"Interactly API\",\"url\":\"https://docs.interactly.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/interactly/ptkIknAxuLhZ0nuk/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=ptkIknAxuLhZ0nuk\u0026q=85\u0026s=1699fd93557b1619c6e3f1d2178e1a98\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.interactly.ai#website\",\"name\":\"Interactly API\",\"url\":\"https://docs.interactly.ai\",\"publisher\":{\"@id\":\"https://docs.interactly.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.interactly.ai/assistant-tools/testing-tools#webpage\",\"url\":\"https://docs.interactly.ai/assistant-tools/testing-tools\",\"name\":\"Testing Tools\",\"description\":\"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues\",\"dateModified\":\"2026-03-13T10:39:41.371Z\",\"isPartOf\":{\"@id\":\"https://docs.interactly.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.interactly.ai/assistant-tools/testing-tools#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.interactly.ai/assistant-tools/testing-tools#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Assistant Tools\",\"item\":\"https://docs.interactly.ai/assistant-tools/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Testing Tools\",\"item\":\"https://docs.interactly.ai/assistant-tools/testing-tools\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.interactly.ai/assistant-tools/testing-tools#article\",\"headline\":\"Testing Tools\",\"name\":\"Testing Tools\",\"description\":\"Use the built-in test runner on the Interactly platform to test your custom tool integrations and troubleshoot configuration issues\",\"url\":\"https://docs.interactly.ai/assistant-tools/testing-tools\",\"mainEntityOfPage\":{\"@id\":\"https://docs.interactly.ai/assistant-tools/testing-tools#webpage\"},\"dateModified\":\"2026-03-13T10:39:41.371Z\",\"publisher\":{\"@id\":\"https://docs.interactly.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.interactly.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Interactly API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Interactly API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/assistant-tools/testing-tools.md","siteName":"Interactly API","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/welcome","groups":[]}]},{"tab":"Documentation","groups":[{"group":"General","pages":[{"title":"Welcome","href":"/general/introduction"},{"title":"Support","href":"/general/support"}]},{"group":"Quickstart","pages":[{"title":"Dashboard","href":"/quickstart/dashboard"},{"title":null,"href":"/quickstart/client-SDK"}]},{"group":"Calls","pages":[{"title":"Live Call Control","href":"/calls/call-features"}]},{"group":"Campaigns","pages":[{"title":"Campaigns","href":"/campaigns/introduction"},{"title":"Single-Modal Campaign","href":"/campaigns/single-modal-campaign"},{"title":"Multi-Modal Campaign","href":"/campaigns/multi-modal-campaign"},{"title":"Retry Policy of Campaigns","href":"/campaigns/retry-policy-of-campaigns"},{"title":"DND \u0026 Callback","href":"/campaigns/dnd-and-callback"}]},{"group":"Workflows","pages":[{"title":"Workflows","href":"/workflows/introduction"},{"title":"Building a Workflow","href":"/workflows/building-a-workflow"},{"title":"Node Types","href":"/workflows/node-types"},{"title":"Workflow Versioning","href":"/workflows/workflow-versioning"},{"title":"Workflow Simulation","href":"/workflows/workflow-simulation"},{"title":"Tools \u0026 Integrations","href":"/workflows/tools-and-integrations"},{"title":"Scheduled \u0026 Triggered Workflows","href":"/workflows/scheduled-and-triggered-workflows"},{"title":"Workflow Webhooks","href":"/workflows/workflow-webhooks"}]},{"group":"Assistant Tools","pages":[{"title":"Assistant Tools","description":"Learn how to configure and enable custom tool integrations to enhance your AI assistant's capabilities with your own business logic and APIs","href":"/assistant-tools/introduction"},{"title":"Testing Tools","href":"/assistant-tools/testing-tools"}]},{"group":"Webhooks","pages":[{"title":"Webhook Events Overview","description":"Complete guide to Interactly webhook events at the assistant level","href":"/webhooks/events/introduction"},{"title":"Status Update Event","href":"/webhooks/events/status-update"},{"title":"Conversation Update Event","href":"/webhooks/events/conversation-update"},{"title":"End of Call Report Event","href":"/webhooks/events/end-of-call-report"},{"title":"Hang Event","href":"/webhooks/events/hang"},{"title":"Error Event","href":"/webhooks/events/error"},{"title":"Local Testing with ngrok","href":"/webhooks/events/testing/ngrok-setup"},{"title":"Live Events Dashboard","href":"/webhooks/events/testing/live-events-dashboard"}]},{"group":"Vendors","pages":[{"title":"Transcribers","href":"/vendors/transcribers"},{"title":"Voices","href":"/vendors/voices"},{"title":"Models","href":"/vendors/models"},{"title":"ElevenLabs TTS Configuration Guide","href":"/vendors/elevenlabs-TTS-recommended-configurations"}]},{"group":"Prompts","pages":[{"title":"Tags","href":"/prompts/tags"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/api-keys"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/release-notes"}]}]},"basePath":"","title":"Testing Tools - Interactly API","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-RDXR0lmt.js","DynamicMarkdown-Z_y464fM.js","zoom-image-lightbox-D5uLWhtj.js","lightbox-handle-r17bVUz3.js"]}