API Documentation

A full public API is currently in preparation. Today, you can already integrate call data into your systems via webhook events.

Status

The Nova API is currently under development. Additional endpoints for assistant management, call logs, analytics, and outbound calls will be rolled out gradually. Once the public API is available, you'll find the full reference here.

Available today: Webhook events

Nova sends webhook events to a URL of your choice as soon as a call begins or ends. This way, you can pull call data, transcripts, and extracted variables directly into your CRM, ticketing system, or your own workflows.

You configure the webhook URL in Nova under Settings → Webhooks.

call.started

Sent when a call begins.

{
  "event": "call.started",
  "call_id": "call_xxxxxxxxxxxx",
  "assistant_id": "asst_xxxxxxxxxxxx",
  "caller_number": "+4917012345678",
  "callee_number": "+4930123456789",
  "direction": "inbound",
  "created_at": "2026-04-16T10:30:00Z"
}

call.completed

Sent when a call has ended. Contains transcript, extracted variables, and a summary.

{
  "event": "call.completed",
  "call_id": "call_xxxxxxxxxxxx",
  "assistant_id": "asst_xxxxxxxxxxxx",
  "duration_seconds": 145,
  "caller_number": "+4917012345678",
  "callee_number": "+4930123456789",
  "direction": "inbound",
  "extracted_variables": {
    "name": "Max Mustermann",
    "email": "max@example.com",
    "reason": "Appointment booking"
  },
  "summary": "The caller wanted to schedule an appointment for next week...",
  "transcript": [
    { "role": "assistant", "content": "Hello, Dr. Müller's practice..." },
    { "role": "user", "content": "Hi, I'd like to book an appointment..." }
  ],
  "metadata": {},
  "created_at": "2026-04-16T10:30:00Z"
}

Outbound calls — Coming Soon

An endpoint for programmatically starting outbound calls is currently under development and will be made available in a future release.

Set Up Call Forwarding FAQ