call.failed

call.failed is the last event of a call that never connected. Its callSessionState is Completed and its status says why. Unanswered, busy, cancelled and failed calls are not charged.

Call events are POSTed to the events_url on the number's routing, which you set with PUT /v1/numbers/{id}/routing. They are not workspace webhooks: you cannot subscribe to them with POST /v1/webhooks.

Payload

The body is flat JSON.

{
  "callSessionState": "Completed",
  "direction": "Outbound",
  "sessionId": "HD_24d73b4518bc",
  "clientDialedNumber": "+254720000000",
  "destinationNumber": "+254720000001",
  "callStartTime": "2026-06-27+10:00:00",
  "durationInSeconds": "0",
  "status": "NoAnswer",
  "isActive": "0"
}

status is one of:

• NoAnswer or Missed: nobody picked up.
• Busy: the line was busy.
• ORIGINATOR_CANCEL: whoever started the call hung up before it was answered.
• Anything else (for example CALL_REJECTED): the call was rejected or could not be routed. Treat any value other than Success as a failed call.

Other fields may be present.

Delivery

• Sent once. Each call event is POSTed to your events_url one time and is not retried. Respond within 5 seconds; the response body is ignored.
• Not signed. These posts carry no X-Sautikit-* headers and no signature. Use an events_url with a path that is hard to guess, and confirm anything that matters with GET /v1/calls/{id}, passing the sessionId.
• Read the state from the body. Every call event has the same shape. callSessionState says which one it is.

Example handler

import express from "express";
 
const app = express();
app.use(express.json());
 
app.post("/sautikit/events", (req, res) => {
  res.sendStatus(200); // answer first, then do the work
  const event = req.body;
  if (event.callSessionState === "Completed" && event.status !== "Success") {
    console.warn(`Call ${event.sessionId} did not connect: ${event.status}`);
    // retry later, or alert your team
  }
});

Next steps

• Set events_url with PUT /v1/numbers/{id}/routing.
• Calls concepts
• The full call record is on GET /v1/calls/{id}.