api-v2-phone-service

Record Incoming Call

Changed on

Record a call that came in to this company's Lev number, answered or not.

Reported once the call has ended, so the record survives a call nobody answered and a call nothing ever transcribed. Safe to retry: the phone service's own call id is the idempotency key, and the same call reported twice returns the one record it already has.

post/api/v2/phone-service/calls

Request

  • Base URL
    https://api.lev.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.lev.com/api/v2/phone-service/calls
  • Auth
    none declared

Request body

phone_service_call_idstring required

The phone service's own identity for this call; the idempotency key

account_idinteger required

The company that owns the Lev number that was called

received_by_user_idinteger nullable

The broker who was rung, when the call reached one

caller_phonestring nullable

The outside caller's number; absent when they withheld caller ID

dial_statusstring nullable
answered_bystring nullable
duration_secondsinteger nullable
started_atstring date-time nullable
ended_atstring date-time nullable
voicemailboolean

Whether the caller left a message; the dial status describes the broker's device either way

Response

Successful Response

phone_call_idstring uuid required

The backend's durable record of this call

Changes