---
title: "Add Agent Tool"
method: POST
path: "/api/v1/agent-integrations/{agent_integration_id}/tools"
tags: ["agent-integrations"]
---

# Add Agent Tool

`POST /api/v1/agent-integrations/{agent_integration_id}/tools`

Add a tool to an agent integration.

## Path parameters

- `agent_integration_id` string, uuid, required

## Request body

- AddAgentToolRequest — Request to add a tool to an agent integration.
  - `tool_name` string, required
  - `executor_type` 'composio' | 'sms' | 'transfer' | 'email' | 'internal' | 'practice_better' | 'webhotelier' | 'knowledge_base' | 'datetime' | 'fidelio' | 'customer_context' | 'call_session' | 'intelligence' | 'weather' | 'exchange_rate' | 'holidays' | 'predicthq' | 'news' | 'handoff' | 'voice_agent_transfer' | 'sub_agent' | 'genesys_cloud' | 'email_verification' | 'analytics_chat' | 'hubspot' | 'web_search' | 'guide_write' | 'guide_read' | 'navigation' | 'metrics_catalog' | 'cloudflare' | 'geo_insights' | 'google_ads' | 'google_analytics' | 'wordpress' | 'website' | 'box', required — Executor type determines which ToolRegistry executor handles this tool. This is the routing key for tool execution - provider-agnostic.
  - `display_name` string, required
  - `description` string, required
  - `provider` string, nullable
  - `provider_action_name` string, nullable
  - `condition` string, nullable
  - `params_schema` object

## Response `200`

Successful Response

- AgentIntegrationToolRead — Response schema for agent integration tool.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `agent_integration_id` string, uuid, required
  - `tool_name` string, required
  - `executor_type` 'composio' | 'sms' | 'transfer' | 'email' | 'internal' | 'practice_better' | 'webhotelier' | 'knowledge_base' | 'datetime' | 'fidelio' | 'customer_context' | 'call_session' | 'intelligence' | 'weather' | 'exchange_rate' | 'holidays' | 'predicthq' | 'news' | 'handoff' | 'voice_agent_transfer' | 'sub_agent' | 'genesys_cloud' | 'email_verification' | 'analytics_chat' | 'hubspot' | 'web_search' | 'guide_write' | 'guide_read' | 'navigation' | 'metrics_catalog' | 'cloudflare' | 'geo_insights' | 'google_ads' | 'google_analytics' | 'wordpress' | 'website' | 'box', required — Executor type determines which ToolRegistry executor handles this tool. This is the routing key for tool execution - provider-agnostic.
  - `provider` string, nullable, required
  - `provider_action_name` string, nullable, required
  - `display_name` string, required
  - `description` string, required
  - `condition` string, nullable, required
  - `params_schema` object, required
  - `enabled` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)