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-qa/rQv06DcAu00ifyO5/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=rQv06DcAu00ifyO5\u0026q=85\u0026s=eb6e3c5ae13dedc06c7f4af81bffb90d","dark":"https://mintcdn.com/interactly-qa/rQv06DcAu00ifyO5/logo/logo_dark.svg?fit=max\u0026auto=format\u0026n=rQv06DcAu00ifyO5\u0026q=85\u0026s=7df0871e3b8149b8337d8f907a078ed7"},"favicon":"https://mintcdn.com/interactly-qa/20698e0YpWVbNAWm/logo/favicon.png?fit=max\u0026auto=format\u0026n=20698e0YpWVbNAWm\u0026q=85\u0026s=d20934ecbb58c578651e1c26eb7e922a","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-qa.interactly.ai"}},"footer":{"socials":{}},"seo":{"indexing":"all"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"interactly-qa","hasAudioNarration":false,"actualSubdomain":"interactly-qa","customDomains":["docs-qa.interactly.ai"],"gitSource":{"type":"github","owner":"interactly","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a548c02370bcde85027ad75","collectionId":"0357f8f2-f8b1-4504-a8e2-46e87b2a8016","schemaVersion":"v3"},"entitlements":{},"buildId":"6a548c02370bcde85027ad75:success","clientVersion":"0.0.3939","searchFilterCounts":[{"language":"default","tag":"API Reference","count":256},{"language":"default","tag":"Workflows","count":140},{"language":"default","tag":"Integrations","count":61},{"language":"default","tag":"Campaigns","count":42},{"language":"default","tag":"APIs","count":38},{"language":"default","tag":"Documentation","count":33},{"language":"default","tag":"Tools","count":15},{"language":"default","tag":"Prompts","count":13},{"language":"default","tag":"Simulations","count":13},{"language":"default","tag":"Integrations Resource Records V2","count":12}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=e2ad435c216b1ac9bed2926cbb04544a`,\"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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=af7c6df3fb4209f0b8cce7c73a978679 280w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=3406e9e603a44eefd93e8edeed9efc09 560w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=e930ef8584812addf27d0f86494ec87d 840w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=4a763e9dc9efd356941018eed6a8b6af 1100w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=ec0fd6a3db2aa7f8fb1e79af7184e721 1650w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/test-tool-click.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=b42d6fab3c7dfbfacda15d76cdd2e9dd 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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=2b3e4a8603205e5cfc280b628143cb75`,\"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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=6b73c8e3499f1584e686dab9458782f7 280w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=a2c8a3a7fec53e5a7857f1408e206536 560w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=8a46b6c48b0f568547212c91bbc77814 840w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=8fadc75b89fc0eb0a4e8f3cbddf51e77 1100w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=0cb3c86659d938b4c0ead6e91279d378 1650w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/view-tool-and-give-params-value.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=013896c552b0488921567eaaad3a0dbb 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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=b1d5366bfa947fb3ff68d7bf164a2672`,\"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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=8d4dc81126300516bddad3c02a96bc24 280w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=1e7649988329edac35cbdaff94c9d314 560w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=686c90e2bc7fb5462b4701ae641d865c 840w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=ea0b8b0138bb7bb3f7213f701d000e4e 1100w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=b057bb3a4c8e50474550d153b5d761d8 1650w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/run-test.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=de2e1489c6524872ed310fc5a9c4ad02 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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=d7a1512097940c2203d381cfd23c5420`,\"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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=3efbfde73a86b8bdb252073e91cedcb7 280w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=0724db1ecea56729af181b19db00d732 560w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=66962f265e4e67633242792938e4afd5 840w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=9ad5a4c68533ca3833640d998aaf8a02 1100w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=f62ff627b3296d96d074d882532f7f4a 1650w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/tool-success-response.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=a7f44252a3b53556524829072b6f1489 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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=76257030ce50989892ace47ac42921b0`,\"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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=be59d1dc85221bb73308adad0314a6dd 280w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=93e86259091cfc6fd5c601113157d9fd 560w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=5501a12361ca459fc785a94ea4824799 840w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=f803ff66aa46d46630003a4dabc6911f 1100w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=bb761d9f35fd44cee61203e30aa9ea13 1650w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=457e58314a20c398fbae25e609b428bd 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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=792b918a48d9d76f8b8774422756f6d0`,\"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-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=699dfa842fe4a948657979e0dc940ce8 280w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=5d1d403e5b32616f1637d30ddb9b7158 560w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=3a01ed28651e9eb51a244af0257d9864 840w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=fd4928b09b17f25184aad79dee0b8e00 1100w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=b6db0084ba18c73bd1f61335a29de8a9 1650w, https://mintcdn.com/interactly-qa/Q9JWUuR-E86u3n6L/images/assistant-tools/wrong-configuration-result-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q9JWUuR-E86u3n6L\u0026q=85\u0026s=80179600d9431b3c5d2f723cbfc2e142 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-qa","siteName":"Interactly API","title":"Testing Tools - Interactly API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-13T09:35:09.788Z","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-qa/ztkxC4YjXG9OzWnh/_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-qa/ztkxC4YjXG9OzWnh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/interactly-qa/ztkxC4YjXG9OzWnh/_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-qa/ztkxC4YjXG9OzWnh/_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-qa/ztkxC4YjXG9OzWnh/_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-qa/ztkxC4YjXG9OzWnh/_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-qa/ztkxC4YjXG9OzWnh/_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-qa/ztkxC4YjXG9OzWnh/_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-qa/ztkxC4YjXG9OzWnh/_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-qa.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-qa.mintlify.app/_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=f91e2e5da38dddab758a5d35\u0026amp;signature=f4a458c7f22b0887b8f7398e4394bab041318ade8a5d3bafed17af613d1ebd35\">\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-qa.mintlify.app/_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=f91e2e5da38dddab758a5d35\u0026amp;signature=f4a458c7f22b0887b8f7398e4394bab041318ade8a5d3bafed17af613d1ebd35\">\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-qa/ztkxC4YjXG9OzWnh/_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-qa.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-qa.interactly.ai/#organization\",\"name\":\"Interactly API\",\"url\":\"https://docs-qa.interactly.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/interactly-qa/rQv06DcAu00ifyO5/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=rQv06DcAu00ifyO5\u0026q=85\u0026s=eb6e3c5ae13dedc06c7f4af81bffb90d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs-qa.interactly.ai#website\",\"name\":\"Interactly API\",\"url\":\"https://docs-qa.interactly.ai\",\"publisher\":{\"@id\":\"https://docs-qa.interactly.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs-qa.interactly.ai/assistant-tools/testing-tools#webpage\",\"url\":\"https://docs-qa.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-13T09:35:09.788Z\",\"isPartOf\":{\"@id\":\"https://docs-qa.interactly.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs-qa.interactly.ai/assistant-tools/testing-tools#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs-qa.interactly.ai/assistant-tools/testing-tools#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Assistant Tools\",\"item\":\"https://docs-qa.interactly.ai/assistant-tools/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Testing Tools\",\"item\":\"https://docs-qa.interactly.ai/assistant-tools/testing-tools\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs-qa.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-qa.interactly.ai/assistant-tools/testing-tools\",\"mainEntityOfPage\":{\"@id\":\"https://docs-qa.interactly.ai/assistant-tools/testing-tools#webpage\"},\"dateModified\":\"2026-03-13T09:35:09.788Z\",\"publisher\":{\"@id\":\"https://docs-qa.interactly.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs-qa.interactly.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Interactly API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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"}]}]},"title":"Testing Tools - Interactly API","buildId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","deploymentId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-CUTvSGqu.js","DynamicMarkdown-BGu84FgU.js","zoom-image-lightbox-ChyC7Hte.js","PlusIcon-DXkY3IBj.js","lightbox-handle-r17bVUz3.js"]}