---
title: "Create Tool"
method: POST
path: "/api/v1/tool"
tags: ["Tool"]
---

# Create Tool

`POST /api/v1/tool`

Create a new tool

## Request body

- IToolCreate
  - `name` string, nullable, required
  - `description` string, nullable, required
  - `org_id` string, uuid, nullable
  - `tool_type` 'system' | 'user', required
  - `authentication` object, required
  - `sdk` object, required
  - `base_url` string, nullable
  - `logo_url` string, nullable
  - `tool_provider` 'leadconnector' | 'hubspot' | 'google_calendar' | 'google_sheets' | 'zoho' | 'freshdesk' | 'insighto' | 'modmed' | 'twilio' | 'custom' | 'fb_messenger' | 'instagram' | 'paypal' | 'postgres' | 'plivo' | 'telnyx' | 'telegram' | 'calendar_pool', required
  - `enabled` boolean, nullable
  - `attributes` object, nullable
  - `category` 'Calendar' | 'CRM' | 'EHR' | 'Support' | 'Communication' | 'System' | 'HRMS' | 'Social' | 'Others' | 'Payment' | 'Database' | 'MCP', required
  - `requires_feature` string, nullable

## Response `201`

Successful Response

- IPostResponseBaseIToolCreate
  - `message` string, nullable
  - `meta` union
    - object
    - unknown
  - `data` IToolCreate
    - `name` string, nullable, required
    - `description` string, nullable, required
    - `org_id` string, uuid, nullable
    - `tool_type` 'system' | 'user', required
    - `authentication` object, required
    - `sdk` object, required
    - `base_url` string, nullable
    - `logo_url` string, nullable
    - `tool_provider` 'leadconnector' | 'hubspot' | 'google_calendar' | 'google_sheets' | 'zoho' | 'freshdesk' | 'insighto' | 'modmed' | 'twilio' | 'custom' | 'fb_messenger' | 'instagram' | 'paypal' | 'postgres' | 'plivo' | 'telnyx' | 'telegram' | 'calendar_pool', required
    - `enabled` boolean, nullable
    - `attributes` object, nullable
    - `category` 'Calendar' | 'CRM' | 'EHR' | 'Support' | 'Communication' | 'System' | 'HRMS' | 'Social' | 'Others' | 'Payment' | 'Database' | 'MCP', required
    - `requires_feature` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/insighto/apis/ragify.md) · [All operations](https://skmtc.net/insighto/apis/ragify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/insighto/ragify/revisions/cdca56191be9/schema)