Skip to main content
POST
Create mid call tool
This endpoint allows you to create a new mid call tool that can be used by your AI assistants to interact with external APIs during calls.

Body Parameters

string
required
Tool name - must contain only lowercase letters and underscores, and start with a letter (e.g., get_weather, book_appointment)
string
required
Detailed explanation of when and how the AI should use this tool (max 255 characters)
string
required
Valid URL of the API endpoint to call
string
required
HTTP method: GET, POST, PUT, PATCH, or DELETE
integer
Request timeout in seconds (1-30, default: 10)
array
HTTP headers to send with the request
array
Parameters that the AI will extract from conversation and send to the endpoint

Response fields

string
Success message
object
The created tool object

Attaching Tools to Assistants

After creating a tool, you need to attach it to an assistant to use it during calls. Tools are managed through the Assistant API:
  • Create Assistant - Use the tool_ids parameter to attach tools when creating an assistant
  • Update Assistant - Use the tool_ids parameter to add, remove, or replace tools on an existing assistant