Skip to main content

​
Base URL

https://api.meetecho.ai/

​
Authentication

All /api/v1/* endpoints require an API key passed in the x-api-key header. 
-H "x-api-key: echo_6f437a610fbb..."
Your API key is returned at signup (in default_project.api_key) and shown exactly once. If you need to create additional keys or rotate an existing one, use the API Keys endpoints. Auth endpoints (/auth/*) are public — no key required.

​
API Key Format

Keys always start with echo_ followed by 64 hex characters: 
echo_6f437a610fbb65e6a2742c60ef3e916a80f638522ff11fcc1c711b75fd958534

​
Endpoint Groups

Auth

Sign up, log in, and refresh tokens.

Customers

Register and manage the people you want to call.

Agents

Create and manage reusable voice personas.

Notifications

Trigger outbound calls and inspect results.

API Keys

Create and revoke project API keys.

Project

Inspect project settings.

Webhook Endpoints

Register and manage webhook endpoints with per-endpoint signing secrets.

Delivery Logs

Inspect delivery history, per-attempt details, and manually retry failures.

​
Error Codes

StatusMeaning
400 Bad RequestValidation error on the request body
401 UnauthorizedMissing or invalid API key
403 ForbiddenValid key but insufficient access
404 Not FoundCustomer, agent, or notification not found in your project/business
409 Conflictexternal_id already exists for this project
All errors return a JSON body: 
{
  "statusCode": 404,
  "message": "Customer not found",
  "error": "Not Found"
}