Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
curl --request POST \
--url https://api.meetecho.ai/v1/agents \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"name": "Appointment Reminder",
"system_prompt": "You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.",
"output_schema": {
"type": "object",
"required": [
"confirmed",
"rescheduling"
],
"properties": {
"confirmed": {
"type": "boolean",
"description": "Whether the customer confirmed their appointment"
},
"rescheduling": {
"type": "boolean",
"description": "Whether the customer wants to reschedule"
},
"preferred_date": {
"type": "string",
"description": "Preferred new date if rescheduling"
},
"preferred_time": {
"type": "string",
"description": "Preferred new time if rescheduling"
}
}
}
}
'import requests
url = "https://api.meetecho.ai/v1/agents"
payload = {
"name": "Appointment Reminder",
"system_prompt": "You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.",
"output_schema": {
"type": "object",
"required": ["confirmed", "rescheduling"],
"properties": {
"confirmed": {
"type": "boolean",
"description": "Whether the customer confirmed their appointment"
},
"rescheduling": {
"type": "boolean",
"description": "Whether the customer wants to reschedule"
},
"preferred_date": {
"type": "string",
"description": "Preferred new date if rescheduling"
},
"preferred_time": {
"type": "string",
"description": "Preferred new time if rescheduling"
}
}
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Appointment Reminder',
system_prompt: 'You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.',
output_schema: {
type: 'object',
required: ['confirmed', 'rescheduling'],
properties: {
confirmed: {
type: 'boolean',
description: 'Whether the customer confirmed their appointment'
},
rescheduling: {type: 'boolean', description: 'Whether the customer wants to reschedule'},
preferred_date: {type: 'string', description: 'Preferred new date if rescheduling'},
preferred_time: {type: 'string', description: 'Preferred new time if rescheduling'}
}
}
})
};
fetch('https://api.meetecho.ai/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meetecho.ai/v1/agents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Appointment Reminder',
'system_prompt' => 'You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.',
'output_schema' => [
'type' => 'object',
'required' => [
'confirmed',
'rescheduling'
],
'properties' => [
'confirmed' => [
'type' => 'boolean',
'description' => 'Whether the customer confirmed their appointment'
],
'rescheduling' => [
'type' => 'boolean',
'description' => 'Whether the customer wants to reschedule'
],
'preferred_date' => [
'type' => 'string',
'description' => 'Preferred new date if rescheduling'
],
'preferred_time' => [
'type' => 'string',
'description' => 'Preferred new time if rescheduling'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meetecho.ai/v1/agents"
payload := strings.NewReader("{\n \"name\": \"Appointment Reminder\",\n \"system_prompt\": \"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.\",\n \"output_schema\": {\n \"type\": \"object\",\n \"required\": [\n \"confirmed\",\n \"rescheduling\"\n ],\n \"properties\": {\n \"confirmed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer confirmed their appointment\"\n },\n \"rescheduling\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer wants to reschedule\"\n },\n \"preferred_date\": {\n \"type\": \"string\",\n \"description\": \"Preferred new date if rescheduling\"\n },\n \"preferred_time\": {\n \"type\": \"string\",\n \"description\": \"Preferred new time if rescheduling\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.meetecho.ai/v1/agents")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Appointment Reminder\",\n \"system_prompt\": \"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.\",\n \"output_schema\": {\n \"type\": \"object\",\n \"required\": [\n \"confirmed\",\n \"rescheduling\"\n ],\n \"properties\": {\n \"confirmed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer confirmed their appointment\"\n },\n \"rescheduling\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer wants to reschedule\"\n },\n \"preferred_date\": {\n \"type\": \"string\",\n \"description\": \"Preferred new date if rescheduling\"\n },\n \"preferred_time\": {\n \"type\": \"string\",\n \"description\": \"Preferred new time if rescheduling\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meetecho.ai/v1/agents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Appointment Reminder\",\n \"system_prompt\": \"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.\",\n \"output_schema\": {\n \"type\": \"object\",\n \"required\": [\n \"confirmed\",\n \"rescheduling\"\n ],\n \"properties\": {\n \"confirmed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer confirmed their appointment\"\n },\n \"rescheduling\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer wants to reschedule\"\n },\n \"preferred_date\": {\n \"type\": \"string\",\n \"description\": \"Preferred new date if rescheduling\"\n },\n \"preferred_time\": {\n \"type\": \"string\",\n \"description\": \"Preferred new time if rescheduling\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "ddb8be3b-a426-4122-b877-a0cba363c89d",
"created_at": "2026-03-18T17:43:46.714Z",
"business_id": "97bfa642-d2cb-46d5-8de8-6d3553c83007",
"name": "Appointment Reminder",
"system_prompt": "You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.",
"output_schema": {
"type": "object",
"required": [
"confirmed",
"rescheduling"
],
"properties": {
"confirmed": {
"type": "boolean"
},
"rescheduling": {
"type": "boolean"
},
"preferred_date": {
"type": "string"
},
"preferred_time": {
"type": "string"
}
}
},
"status": "active",
"updated_at": "2026-03-18T17:43:46.714Z"
}Agents define a reusable voice persona with a system prompt and optional output schema for structured data extraction.
curl --request POST \
--url https://api.meetecho.ai/v1/agents \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"name": "Appointment Reminder",
"system_prompt": "You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.",
"output_schema": {
"type": "object",
"required": [
"confirmed",
"rescheduling"
],
"properties": {
"confirmed": {
"type": "boolean",
"description": "Whether the customer confirmed their appointment"
},
"rescheduling": {
"type": "boolean",
"description": "Whether the customer wants to reschedule"
},
"preferred_date": {
"type": "string",
"description": "Preferred new date if rescheduling"
},
"preferred_time": {
"type": "string",
"description": "Preferred new time if rescheduling"
}
}
}
}
'import requests
url = "https://api.meetecho.ai/v1/agents"
payload = {
"name": "Appointment Reminder",
"system_prompt": "You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.",
"output_schema": {
"type": "object",
"required": ["confirmed", "rescheduling"],
"properties": {
"confirmed": {
"type": "boolean",
"description": "Whether the customer confirmed their appointment"
},
"rescheduling": {
"type": "boolean",
"description": "Whether the customer wants to reschedule"
},
"preferred_date": {
"type": "string",
"description": "Preferred new date if rescheduling"
},
"preferred_time": {
"type": "string",
"description": "Preferred new time if rescheduling"
}
}
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Appointment Reminder',
system_prompt: 'You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.',
output_schema: {
type: 'object',
required: ['confirmed', 'rescheduling'],
properties: {
confirmed: {
type: 'boolean',
description: 'Whether the customer confirmed their appointment'
},
rescheduling: {type: 'boolean', description: 'Whether the customer wants to reschedule'},
preferred_date: {type: 'string', description: 'Preferred new date if rescheduling'},
preferred_time: {type: 'string', description: 'Preferred new time if rescheduling'}
}
}
})
};
fetch('https://api.meetecho.ai/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meetecho.ai/v1/agents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Appointment Reminder',
'system_prompt' => 'You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.',
'output_schema' => [
'type' => 'object',
'required' => [
'confirmed',
'rescheduling'
],
'properties' => [
'confirmed' => [
'type' => 'boolean',
'description' => 'Whether the customer confirmed their appointment'
],
'rescheduling' => [
'type' => 'boolean',
'description' => 'Whether the customer wants to reschedule'
],
'preferred_date' => [
'type' => 'string',
'description' => 'Preferred new date if rescheduling'
],
'preferred_time' => [
'type' => 'string',
'description' => 'Preferred new time if rescheduling'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meetecho.ai/v1/agents"
payload := strings.NewReader("{\n \"name\": \"Appointment Reminder\",\n \"system_prompt\": \"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.\",\n \"output_schema\": {\n \"type\": \"object\",\n \"required\": [\n \"confirmed\",\n \"rescheduling\"\n ],\n \"properties\": {\n \"confirmed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer confirmed their appointment\"\n },\n \"rescheduling\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer wants to reschedule\"\n },\n \"preferred_date\": {\n \"type\": \"string\",\n \"description\": \"Preferred new date if rescheduling\"\n },\n \"preferred_time\": {\n \"type\": \"string\",\n \"description\": \"Preferred new time if rescheduling\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.meetecho.ai/v1/agents")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Appointment Reminder\",\n \"system_prompt\": \"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.\",\n \"output_schema\": {\n \"type\": \"object\",\n \"required\": [\n \"confirmed\",\n \"rescheduling\"\n ],\n \"properties\": {\n \"confirmed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer confirmed their appointment\"\n },\n \"rescheduling\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer wants to reschedule\"\n },\n \"preferred_date\": {\n \"type\": \"string\",\n \"description\": \"Preferred new date if rescheduling\"\n },\n \"preferred_time\": {\n \"type\": \"string\",\n \"description\": \"Preferred new time if rescheduling\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meetecho.ai/v1/agents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Appointment Reminder\",\n \"system_prompt\": \"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.\",\n \"output_schema\": {\n \"type\": \"object\",\n \"required\": [\n \"confirmed\",\n \"rescheduling\"\n ],\n \"properties\": {\n \"confirmed\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer confirmed their appointment\"\n },\n \"rescheduling\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the customer wants to reschedule\"\n },\n \"preferred_date\": {\n \"type\": \"string\",\n \"description\": \"Preferred new date if rescheduling\"\n },\n \"preferred_time\": {\n \"type\": \"string\",\n \"description\": \"Preferred new time if rescheduling\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "ddb8be3b-a426-4122-b877-a0cba363c89d",
"created_at": "2026-03-18T17:43:46.714Z",
"business_id": "97bfa642-d2cb-46d5-8de8-6d3553c83007",
"name": "Appointment Reminder",
"system_prompt": "You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule.",
"output_schema": {
"type": "object",
"required": [
"confirmed",
"rescheduling"
],
"properties": {
"confirmed": {
"type": "boolean"
},
"rescheduling": {
"type": "boolean"
},
"preferred_date": {
"type": "string"
},
"preferred_time": {
"type": "string"
}
}
},
"status": "active",
"updated_at": "2026-03-18T17:43:46.714Z"
}Echo API key — format: echo_<64 hex chars>. Returned once on signup.
"Appointment Reminder"
Supports built-in variables: {{business_name}}, {{business_summary}},
{{recipient_name}}, {{recipient_first_name}}, {{message}}, {{context}}.
Any additional {{key}} tokens are filled from the variables map on each notification.
"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule."
JSON Schema for structured data extraction after the call. Omit for unstructured calls.
{ "type": "object", "required": ["confirmed", "rescheduling"], "properties": { "confirmed": { "type": "boolean", "description": "Whether the customer confirmed their appointment" }, "rescheduling": { "type": "boolean", "description": "Whether the customer wants to reschedule" }, "preferred_date": { "type": "string", "description": "Preferred new date if rescheduling" }, "preferred_time": { "type": "string", "description": "Preferred new time if rescheduling" } } }
Agent created
"ddb8be3b-a426-4122-b877-a0cba363c89d"
"97bfa642-d2cb-46d5-8de8-6d3553c83007"
"Appointment Reminder"
"You are {{agent_name}}, a friendly appointment reminder assistant for {{business_name}}. You are calling {{recipient_first_name}} to remind them about their upcoming appointment on {{appointment_date}} at {{appointment_time}}. Confirm they can make it, or collect details to reschedule."
{ "type": "object", "required": ["confirmed", "rescheduling"], "properties": { "confirmed": { "type": "boolean" }, "rescheduling": { "type": "boolean" }, "preferred_date": { "type": "string" }, "preferred_time": { "type": "string" } } }
active, disabled "active"
"2026-03-18T17:43:46.714Z"
"2026-03-18T17:43:46.714Z"