API Reference

Developer-friendly API

Build powerful voice AI integrations with our RESTful API. Manage agents, handle calls, and access analytics programmatically with clean, well-documented endpoints.

Quick Start

Make your first API call

Get up and running in seconds. Grab your API key from the dashboard and try this command to list your agents.

List all agents
curl -X GET https://jagcall.com/v1/agents \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json"

Replace YOUR_API_KEY with your actual API key from the API page in your dashboard.

Capabilities

Built for developers

Everything you need to integrate voice AI into your application.

REST API

Clean, intuitive endpoints for managing agents, calls, phone numbers, SMS, and analytics. JSON request and response format throughout.

Webhooks

Real-time event notifications for call started, call ended, SMS received, appointment booked, and more. Configure per-agent or globally.

Works With Any Stack

Standard REST and JSON over HTTPS. Use curl, Python, Node.js, or any HTTP client — no proprietary SDK required.

Rate Limiting

Per-endpoint rate limits keep the platform fast and fair. When a limit is exceeded, the API responds with 429 so clients can back off and retry.

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from your dashboard with granular permission scopes.

  • Bearer token authentication on every request
  • Org-scoped keys — each key accesses a single organization
  • Rotate keys instantly from the dashboard
  • Create separate named keys per environment or integration
Request header
Authorization: Bearer jc_live_abc123...

Example

Create an agent via API

Deploy a fully configured voice agent with a single API call. Set the voice, greeting, instructions, tools, and phone number all at once.

POST /v1/agents
curl -X POST https://jagcall.com/v1/agents \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "name": "Reception Agent",    "system_prompt": "You are a friendly receptionist. Book appointments, answer FAQs, and transfer complex requests to a human agent.",    "greeting_message": "Hello! Thanks for calling. How can I help you today?",    "llm_provider": "openai",    "llm_model": "gpt-4o-mini",    "tts_provider": "cartesia"  }'

API Key Management

Create, rotate, and revoke API keys from your dashboard. Keys are shown once at creation and stored hashed.

Base URL

All endpoints are available at https://jagcall.com/v1. HTTPS is required for all requests.

Developer Guides

Step-by-step guides for getting started, webhooks, and OAuth.

Start building with the JagCall API

Create your free account, generate an API key, and deploy your first voice agent in minutes. Full API access on every plan.