ResourcesTroubleshooting

Tools & Toolkits

Debugging and troubleshooting tool execution issues

Tool execution failures (401/403 errors)

Authentication and permission errors typically occur due to:

Missing scopes

Check if your connection has the required scopes using this API:

$curl --location 'https://backend.composio.dev/api/v3/tools/get_scopes_required' \
>--header 'x-api-key: YOUR_COMPOSIO_API_KEY' \
>--header 'Content-Type: application/json' \
>--data '{
>    "tools": [
>        "SLACK_SENDS_A_MESSAGE_TO_A_SLACK_CHANNEL",
>        "SLACK_CREATE_A_REMINDER"    
>    ]
>}'

Insufficient permissions

Verify the connected account has necessary permissions:

  • Admin requirements: Some tools require admin-level access
  • Paid accounts: Certain toolkits need paid subscriptions
    • Example: MS Teams requires Microsoft 365 account + Azure AD tenant

Tool not working

  • Check tool-specific documentation for requirements
  • Verify the connected account is active and properly authenticated
  • Test with the latest SDK version

Reporting tool issues

When reporting to support, provide:

  • Error message: Complete error details
  • Log ID: From the error response
  • Tool name: Exact tool slug being executed
  • Connected account ID: Account used for execution

Getting help