API Reference›Servicing Plane›Connector callbacks›Authorize a voice dial

Authorize a voice dial

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatchId}/dial-authorizationImplementedConnector callbackConnector authority ·Dispatch-bound task-scoped worker token

Rechecks the dispatch-bound target at execution time. This connector callback uses a task-scoped worker token and accepts no body.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/$DISPATCH_ID/dial-authorization \
  -H "X-LendEasy-Voice-Task-Token: $DISPATCH_TOKEN"

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/${dispatchId}/dial-authorization`, {
  method: "POST",
  headers: { "X-LendEasy-Voice-Task-Token": dispatchToken },
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatch_id}/dial-authorization",
  headers={"X-LendEasy-Voice-Task-Token": dispatch_token},
)

{
  "dispatchId": 731,
  "contactAttemptId": 8801,
  "decisionRef": "decision-441",
  "outcome": "ALLOWED",
  "dialAuthorized": true,
  "expiresAt": "2026-07-25T19: 05: 30-07: 00"
}

{
  "error": "The callback body is invalid."
}

{
  "error": "Invalid or missing connector authority."
}

{
  "error": "No visible voice dispatch exists."
}

{
  "error": "The callback conflicts with current dispatch state."
}

Path & query parameters

Field	Type	Description
dispatchId required in path	integer	Positive numeric dispatch identifier.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/$DISPATCH_ID/dial-authorization \
  -H "X-LendEasy-Voice-Task-Token: $DISPATCH_TOKEN"

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/${dispatchId}/dial-authorization`, {
  method: "POST",
  headers: { "X-LendEasy-Voice-Task-Token": dispatchToken },
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatch_id}/dial-authorization",
  headers={"X-LendEasy-Voice-Task-Token": dispatch_token},
)

{
  "dispatchId": 731,
  "contactAttemptId": 8801,
  "decisionRef": "decision-441",
  "outcome": "ALLOWED",
  "dialAuthorized": true,
  "expiresAt": "2026-07-25T19: 05: 30-07: 00"
}

{
  "error": "The callback body is invalid."
}

{
  "error": "Invalid or missing connector authority."
}

{
  "error": "No visible voice dispatch exists."
}

{
  "error": "The callback conflicts with current dispatch state."
}