Tools & Toolkits

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

• Email: support@composio.dev
• Discord: #support-form