Python SDK 0.17.0 makes sessions first-class
Python SDKcomposio 0.17.0 moves Tool Router onto a sessions-first API. It also adds webhook helpers and makes the current shared-connection ACL API easier to discover.
SDK versions
Sessions and MCP
composio.sessions.create(...) is now the canonical sessions entry point. composio.create(...) and composio.use(...) remain supported shortcuts, while composio.tool_router is deprecated as an alias for the same object.
Sessions return native tools by default. Set mcp=True when a typed MCP session is required. The runtime object is unchanged, but the explicit option makes the MCP dependency visible in application code.
New APIs and behavior
triggers.parse()parses an incoming webhook request and can verify its signature. Passing an emptyverify_secretnow raises instead of silently skipping verification.triggers.set_webhook_subscription()creates or updates the project webhook subscription.connected_accounts.update_acl()is the primary shared-connection ACL patch helper.experimental.update_acl()remains as a deprecated alias.- Prefer
sandboxfor session code-execution configuration.workbenchremains an accepted alias.