channels
voice
calls-markup-language
markup-language-instructions-async

Recording status callback API

When the Infobip platform finishes processing a recording requested by a Record instruction, it generates a request to the callback URL configured on Record or StartRecording instruction. The request carries the call context together with the recording status.

postWebhooksend-recording-status-callback

Payload

callIdstring

Unique identifier of the call.

fromstring

The phone number of the caller in the E.164 format.

tostring

The phone number of the callee in the E.164 format.

direction'INBOUND' | 'OUTBOUND'

The direction of the call. Possible values are: INBOUND, OUTBOUND.

startTimestring date-time

The timestamp when the call started, in ISO-8601 UTC format (yyyy-MM-dd'T'HH:mm:ss.SSSZ).

recordingFileIdstring

The unique identifier of the recording file.

recordingStatus'in-progress' | 'completed'

Recording status delivered with the record callback.

Example payload

{
  "callId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "from": "41793026834",
  "to": "41793026835",
  "direction": "INBOUND",
  "endpoint": {
    "type": "PHONE",
    "phoneNumber": "41793026834"
  },
  "startTime": "2025-04-04T11:38:01.724Z",
  "recordingFileId": "b83f049e-6b2a-4111-bbeb-32426fe0a737",
  "recordingStatus": "in-progress"
}

Response

Your server returns this code if it accepts the callback.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.