---
title: "Dev Init Call"
method: POST
path: "/calls/dev-init"
tags: ["Calls"]
---

# Dev Init Call

`POST /calls/dev-init`

Initialize a call record for local development (DEV ENVIRONMENT ONLY).

This endpoint allows local bot development without going through Twilio webhooks.
It creates a call record with test defaults and returns the call_id that the bot
can use to finalize the call information via PATCH /calls/{call_id}.

Only available in development environment (app_env=dev).
Requires a per-customer agent token for authentication.

Defaults applied:
- is_test=True
- phone_number="+15555551234" (if not provided)
- direction="inbound" (if not provided)
- start_time=now
- session_id=auto-generated dev session ID

Returns:
- **call_id**: The UUID of the created call record
- **call**: Full call object with all details

## Request body

- DevInitCallRequest — Request to initialize a call for local development (dev environment only).
  - `direction` string, nullable — Direction of the call: 'inbound' or 'outbound'
  - `phone_number` string, nullable — Phone number associated with the call (defaults to +15555551234)

## Response `201`

Successful Response

- DevInitCallResponse — Response after initializing a development call.
  - `call_id` string, uuid, required — The ID of the created call record
  - `call` CallResponse, required — Full call record response.
    - `call_id` string, uuid, required
    - `customer_id` string, uuid, required
    - `case_id` string, uuid, nullable, required
    - `created_at` string, date-time, required
    - `phone_number` string, nullable, required
    - `system_phone_number` string, nullable, required
    - `duration_seconds` integer, nullable, required
    - `direction` string, required
    - `channel` string, nullable
    - `status` string, required
    - `caller_client_status` string, nullable, required
    - `is_test` boolean, required
    - `transferred` boolean, required
    - `call_sid` string, nullable, required
    - `forwarded_call_sid` string, nullable, required
    - `session_id` string, nullable, required
    - `start_time` string, date-time, nullable, required
    - `end_time` string, date-time, nullable, required
    - `caller_name` string, nullable, required
    - `caller_email` string, nullable, required
    - `has_error` boolean, required
    - `error_description` string, nullable, required
    - `errors` object[], nullable
    - `quality_score` string, nullable, required
    - `quality_reason` string, nullable, required
    - `goal_accomplished` boolean, nullable, required
    - `goal_reason` string, nullable, required
    - `caller_hung_up` boolean, nullable, required
    - `billable` boolean, nullable
    - `hit_voicemail` boolean, nullable
    - `call_provider` string, nullable — Voice agent provider: 'pipecat', 'vapi', or 'ringcentral' (null means pipecat/legacy)
    - `cnam_caller_name` string, nullable — Caller ID name from Twilio CNAM lookup (display only - may be account holder, not actual caller)
    - `cnam_caller_type` string, nullable — Caller type from CNAM: 'CONSUMER' or 'BUSINESS'
    - `next_call_id` string, uuid, nullable
    - `previous_call_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)