Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat(sdk): forward user_id on triggers.create for trigger 2FA (#3576)

Anshu Garga94715f57798
diff --git a/.changeset/forward-trigger-user-id.md b/.changeset/forward-trigger-user-id.md
new file mode 100644
index 000000000..15e17c0e0
--- /dev/null
+++ b/.changeset/forward-trigger-user-id.md
@@ -0,0 +1,5 @@
+---
+"@composio/core": minor
+---
+
+Forward `userId` when creating trigger instances so trigger 2FA flows can verify connected account ownership.
diff --git a/python/composio/core/models/triggers.py b/python/composio/core/models/triggers.py
index 15cd4f2ce..6f6c36539 100644
--- a/python/composio/core/models/triggers.py
+++ b/python/composio/core/models/triggers.py
@@ -842,6 +842,11 @@ class Triggers(Resource):
"please provide valid `connected_account` or `user_id`"
)
+ # Forward user_id so 2FA-enabled projects can verify the pinned connected
+ # account belongs to this user (backends without 2FA ignore it). Sent via
+ # extra_body until composio-client regenerates with the field.
+ extra_body = {"user_id": user_id} if user_id is not None else {}
+
return self._client.trigger_instances.upsert(
slug=slug,
connected_account_id=connected_account_id,
@@ -849,6 +854,7 @@ class Triggers(Resource):
body_trigger_config_1=(
trigger_config if trigger_config is not None else omit
),
+ extra_body=extra_body,
)
def _get_connected_account_for_user(self, trigger: str, user_id: str) -> str:
diff --git a/python/providers/anthropic/pyproject.toml b/python/providers/anthropic/pyproject.toml
index b568f719f..d083fb00e 100644
--- a/python/providers/anthropic/pyproject.toml
+++ b/python/providers/anthropic/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-anthropic"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your Anthropic LLMs."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/anthropic/setup.py b/python/providers/anthropic/setup.py
index 78d91b7a7..f2b9be594 100644
--- a/python/providers/anthropic/setup.py
+++ b/python/providers/anthropic/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_anthropic",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Anthropic LLMs.",
diff --git a/python/providers/autogen/pyproject.toml b/python/providers/autogen/pyproject.toml
index 6e2cda895..7b36b4fec 100644
--- a/python/providers/autogen/pyproject.toml
+++ b/python/providers/autogen/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-autogen"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your autogen agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/autogen/setup.py b/python/providers/autogen/setup.py
index 299e09d31..4c6f1d12d 100644
--- a/python/providers/autogen/setup.py
+++ b/python/providers/autogen/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_autogen",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Autogen agent.",
diff --git a/python/providers/claude_agent_sdk/pyproject.toml b/python/providers/claude_agent_sdk/pyproject.toml
index 14cdd2a6a..83a79876f 100644
--- a/python/providers/claude_agent_sdk/pyproject.toml
+++ b/python/providers/claude_agent_sdk/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-claude-agent-sdk"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with Claude Code Agents SDK."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/claude_agent_sdk/setup.py b/python/providers/claude_agent_sdk/setup.py
index 7054c9d17..4b68308c2 100644
--- a/python/providers/claude_agent_sdk/setup.py
+++ b/python/providers/claude_agent_sdk/setup.py
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
setup(
name="composio_claude_agent_sdk",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get array of tools for Claude Agent SDK",
diff --git a/python/providers/crewai/pyproject.toml b/python/providers/crewai/pyproject.toml
index 89291a5d4..26778ccdc 100644
--- a/python/providers/crewai/pyproject.toml
+++ b/python/providers/crewai/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-crewai"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your CrewAI agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/crewai/setup.py b/python/providers/crewai/setup.py
index 5c96e7951..0a78c7314 100644
--- a/python/providers/crewai/setup.py
+++ b/python/providers/crewai/setup.py
@@ -6,7 +6,7 @@ from setuptools import setup
setup(
name="composio_crewai",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your CrewAI agent.",
diff --git a/python/providers/gemini/pyproject.toml b/python/providers/gemini/pyproject.toml
index d3cbf43ec..9131a95f2 100644
--- a/python/providers/gemini/pyproject.toml
+++ b/python/providers/gemini/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-gemini"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your Gemini agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/gemini/setup.py b/python/providers/gemini/setup.py
index 7f1e1edf3..9941381db 100644
--- a/python/providers/gemini/setup.py
+++ b/python/providers/gemini/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_gemini",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Gemini agent.",
diff --git a/python/providers/google/pyproject.toml b/python/providers/google/pyproject.toml
index 439e9b258..682321069 100644
--- a/python/providers/google/pyproject.toml
+++ b/python/providers/google/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-google"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/google/setup.py b/python/providers/google/setup.py
index b499d9932..4cea2605f 100644
--- a/python/providers/google/setup.py
+++ b/python/providers/google/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_google",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
diff --git a/python/providers/google_adk/pyproject.toml b/python/providers/google_adk/pyproject.toml
index 193e7acff..2819e6a6c 100644
--- a/python/providers/google_adk/pyproject.toml
+++ b/python/providers/google_adk/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-google-adk"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/google_adk/setup.py b/python/providers/google_adk/setup.py
index 4cf34f424..6428d62b7 100644
--- a/python/providers/google_adk/setup.py
+++ b/python/providers/google_adk/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_google_adk",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
diff --git a/python/providers/langchain/pyproject.toml b/python/providers/langchain/pyproject.toml
index 9d756acd2..4b897bfd9 100644
--- a/python/providers/langchain/pyproject.toml
+++ b/python/providers/langchain/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-langchain"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your Langchain agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/langchain/setup.py b/python/providers/langchain/setup.py
index 2dc099cc1..b5d680d62 100644
--- a/python/providers/langchain/setup.py
+++ b/python/providers/langchain/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_langchain",
- version="0.14.0",
+ version="0.15.0",
author="composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Langchain agent.",
diff --git a/python/providers/langgraph/pyproject.toml b/python/providers/langgraph/pyproject.toml
index 9106ee3e8..709fe86a5 100644
--- a/python/providers/langgraph/pyproject.toml
+++ b/python/providers/langgraph/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-langgraph"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get array of tools with LangGraph Agent Workflows."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/langgraph/setup.py b/python/providers/langgraph/setup.py
index 487bbb543..ab83095c7 100644
--- a/python/providers/langgraph/setup.py
+++ b/python/providers/langgraph/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_langgraph",
- version="0.14.0",
+ version="0.15.0",
author="composio",
author_email="[email protected]",
description="Use Composio to get array of tools with LangGraph Agent Workflows",
diff --git a/python/providers/llamaindex/pyproject.toml b/python/providers/llamaindex/pyproject.toml
index 56d2da0e6..e68fbc2b5 100644
--- a/python/providers/llamaindex/pyproject.toml
+++ b/python/providers/llamaindex/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-llamaindex"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/llamaindex/setup.py b/python/providers/llamaindex/setup.py
index 59a8c477c..f0a3cb41c 100644
--- a/python/providers/llamaindex/setup.py
+++ b/python/providers/llamaindex/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_llamaindex",
- version="0.14.0",
+ version="0.15.0",
author="composio",
author_email="[email protected]",
description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
diff --git a/python/providers/openai/pyproject.toml b/python/providers/openai/pyproject.toml
index d36a0d0f7..b3210323d 100644
--- a/python/providers/openai/pyproject.toml
+++ b/python/providers/openai/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-openai"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get an array of tools with your OpenAI Function Call."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/openai/setup.py b/python/providers/openai/setup.py
index b16ceb958..133a6a237 100644
--- a/python/providers/openai/setup.py
+++ b/python/providers/openai/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_openai",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your OpenAI Function Call.",
diff --git a/python/providers/openai_agents/pyproject.toml b/python/providers/openai_agents/pyproject.toml
index b75738ece..f2e37e52a 100644
--- a/python/providers/openai_agents/pyproject.toml
+++ b/python/providers/openai_agents/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-openai-agents"
-version = "0.14.0"
+version = "0.15.0"
description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/openai_agents/setup.py b/python/providers/openai_agents/setup.py
index ece829d75..18fc1650d 100644
--- a/python/providers/openai_agents/setup.py
+++ b/python/providers/openai_agents/setup.py
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
setup(
name="composio_openai_agents",
- version="0.14.0",
+ version="0.15.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get array of strongly typed tools for OpenAI Agents",
diff --git a/python/pyproject.toml b/python/pyproject.toml
index 58ea07e96..bdc955c54 100644
--- a/python/pyproject.toml
+++ b/python/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio"
-version = "0.14.0"
+version = "0.15.0"
description = "SDK for integrating Composio with your applications."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/tests/test_triggers.py b/python/tests/test_triggers.py
index 17122e456..d42c17770 100644
--- a/python/tests/test_triggers.py
+++ b/python/tests/test_triggers.py
@@ -248,6 +248,8 @@ class TestTriggers:
call_kwargs = mock_client.trigger_instances.upsert.call_args.kwargs
assert call_kwargs["connected_account_id"] == "conn-456"
assert call_kwargs["toolkit_versions"] is None
+ # user_id forwarded for trigger 2FA ownership verification
+ assert call_kwargs["extra_body"] == {"user_id": "user-123"}
assert result == mock_response
def test_create_with_custom_toolkit_versions(
diff --git a/ts/packages/core/src/models/Triggers.ts b/ts/packages/core/src/models/Triggers.ts
index 1454aa7ff..18d09bc23 100644
--- a/ts/packages/core/src/models/Triggers.ts
+++ b/ts/packages/core/src/models/Triggers.ts
@@ -1,5 +1,8 @@
import ComposioClient, { APIError } from '@composio/client';
-import { TriggersTypeRetrieveEnumResponse } from '@composio/client/resources/index';
+import {
+ TriggersTypeRetrieveEnumResponse,
+ type TriggerInstanceUpsertParams as ClientTriggerInstanceUpsertParams,
+} from '@composio/client/resources/index';
import {
TriggerInstanceUpsertResponse,
TriggerInstanceUpsertParamsSchema,
@@ -227,11 +230,20 @@ export class Triggers<TProvider extends BaseComposioProvider<unknown, unknown, u
throw error;
}
- const result = await this.client.triggerInstances.upsert(slug, {
+ // Forward user_id so 2FA-enabled projects can verify the pinned connected
+ // account is owned by this user (backends without 2FA ignore it). The
+ // `& { user_id }` bridges until @composio/client regenerates from the
+ // updated OpenAPI spec; drop it once the field lands on the generated type.
+ const upsertParams: ClientTriggerInstanceUpsertParams & {
+ user_id?: string;
+ } = {
connected_account_id: connectedAccountId,
trigger_config: parsedBody.data.triggerConfig,
toolkit_versions: this.toolkitVersions,
- });
+ user_id: userId,
+ };
+
+ const result = await this.client.triggerInstances.upsert(slug, upsertParams);
return {
triggerId: result.trigger_id,
diff --git a/ts/packages/core/test/models/triggers.test.ts b/ts/packages/core/test/models/triggers.test.ts
index 71334af90..439749a54 100644
--- a/ts/packages/core/test/models/triggers.test.ts
+++ b/ts/packages/core/test/models/triggers.test.ts
@@ -322,6 +322,7 @@ describe('Triggers', () => {
connected_account_id: body.connectedAccountId,
trigger_config: body.triggerConfig,
toolkit_versions: 'latest',
+ user_id: userId,
});
expect(result).toEqual({ triggerId: mockTriggerUpsertResponse.trigger_id });
});
@@ -340,6 +341,7 @@ describe('Triggers', () => {
connected_account_id: 'conn-456',
trigger_config: bodyWithoutConnectedAccount.triggerConfig,
toolkit_versions: 'latest',
+ user_id: userId,
});
expect(logger.warn).toHaveBeenCalledWith(
`[Warn] Multiple connected accounts found for user ${userId}, using the first one. Pass connectedAccountId to select a specific account.`
diff --git a/uv.lock b/uv.lock
index 066a09569..6d15ffc46 100644
--- a/uv.lock
+++ b/uv.lock
@@ -592,7 +592,7 @@ wheels = [
[[package]]
name = "composio"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python" }
dependencies = [
{ name = "composio-client" },
@@ -649,7 +649,7 @@ dev = [
[[package]]
name = "composio-anthropic"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python/providers/anthropic" }
dependencies = [
{ name = "anthropic" },
@@ -681,7 +681,7 @@ wheels = [
[[package]]
name = "composio-crewai"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python/providers/crewai" }
dependencies = [
{ name = "composio" },
@@ -696,7 +696,7 @@ requires-dist = [
[[package]]
name = "composio-gemini"
-version = "0.14.0"
+version = "0.15.0"
source = { virtual = "python/providers/gemini" }
dependencies = [
{ name = "composio" },
@@ -711,7 +711,7 @@ requires-dist = [
[[package]]
name = "composio-google"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python/providers/google" }
dependencies = [
{ name = "composio" },
@@ -726,7 +726,7 @@ requires-dist = [
[[package]]
name = "composio-google-adk"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python/providers/google_adk" }
dependencies = [
{ name = "composio" },
@@ -741,7 +741,7 @@ requires-dist = [
[[package]]
name = "composio-langchain"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python/providers/langchain" }
dependencies = [
{ name = "composio" },
@@ -756,7 +756,7 @@ requires-dist = [
[[package]]
name = "composio-openai"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python/providers/openai" }
dependencies = [
{ name = "composio" },
@@ -771,7 +771,7 @@ requires-dist = [
[[package]]
name = "composio-openai-agents"
-version = "0.14.0"
+version = "0.15.0"
source = { editable = "python/providers/openai_agents" }
dependencies = [
{ name = "composio" },