Error callback API

When the Infobip platform fails to retrieve or execute Markup Language instructions, it generates a request to the errorUrl you set up in the Markup Language configuration. The request carries the call context together with the error code and details that describe the failure.

postWebhookreceive-markup-language-error

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).

errorCodestring

Error category code.

errorDetailsstring

Detailed error message.

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",
  "errorCode": "HTTP_ERROR",
  "errorDetails": "Error while reaching https://{yourDomain}/your/webhook/path"
}

Response

Example response

{
  "actions": [
    {
      "say": {
        "language": "en",
        "voicePreferences": {
          "voice": "Joanna"
        }
      }
    }
  ]
}

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.