API Reference

Base URL

https://api.meetecho.ai/v1

Authentication

All /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 (/v1/auth/*) are public — no key required.

API Key Format

Keys always start with echo_ followed by 64 hex characters:

echo_6f437a610fbb65e6a2742c60ef3e916a80f638522ff11fcc1c711b75fd958534

Endpoint Groups

Auth

Customers

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

Delivery Logs

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

Error Codes

Status	Meaning
`400 Bad Request`	Validation error on the request body
`401 Unauthorized`	Missing or invalid API key
`403 Forbidden`	Valid key but insufficient access
`404 Not Found`	Customer, agent, or notification not found in your project/business
`409 Conflict`	`external_id` already exists for this project

All errors return a JSON body:

{
  "statusCode": 404,
  "message": "Customer not found",
  "error": "Not Found"
}

​Base URL

​Authentication

​API Key Format

​Endpoint Groups