Skip to main content

​
Overview

Custom tools let you connect your own API endpoints to your agent. This enables powerful integrations like checking appointment availability, looking up order status, or creating bookings — all triggered naturally during a phone conversation.

​
Creating a custom tool

1

Open the tools section

Go to your agent’s settings → Tools tab and click Create custom tool.
2

Define the tool

Fill in:
  • Name — a descriptive name (e.g. check_availability)
  • Description — explain what the tool does. The AI model uses this to decide when to invoke it.
  • Parameters — define the input parameters the tool accepts (as JSON Schema).
3

Configure the endpoint

Set the API endpoint your tool calls:
  • URL — the full endpoint URL
  • Method — GET, POST, PUT, or DELETE
  • Headers — any required headers (e.g. API key, content type)
4

Add authentication

Add your API key as a header:
5

Test and save

Save the tool and test it with a call to verify it works correctly.

​
Parameter definition

Parameters tell the AI model what information to extract from the conversation and pass to your API. Define them using JSON Schema:
Write clear descriptions for each parameter. The AI model uses these descriptions to understand what information to extract from the caller’s words.

​
Example: appointment checker

A hair salon wants their agent to check appointment availability: Tool configuration:
  • Name: check_availability
  • Description: “Check if there are available time slots on a given date for a specific service.”
  • Endpoint: https://api.salon.com/availability
  • Method: GET
Agent instructions:
Your API endpoint must respond within 10 seconds. Slower responses will cause noticeable pauses during the conversation.