API Reference›Servicing Plane›Connector callbacks›Ingest a channel gateway event

Ingest a channel gateway event

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/channel-events/{gatewayCode}ImplementedConnector callbackConnector authority ·Gateway signature or service authentication

Verifies a pinned gateway signature over the exact JSON bytes and normalizes the configured provider event. The example is the MANUAL adapter’s normalized body; live adapters retain their pinned gateway-specific shape.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/channel-events/$GATEWAY_CODE \
  -H "X-LendEasy-Gateway-Signature: $GATEWAY_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
  "gatewayEventRef": "gateway-event-991",
  "eventType": "CUSTOMER_SMS_OPT_OUT",
  "channel": "SMS",
  "occurredAt": "2026-07-25T18: 30:00Z",
  "relatedObjectType": "MESSAGE",
  "relatedObjectRef": "message-71",
  "normalizedStatus": "OPTED_OUT"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/channel-events/${gatewayCode}`, {
  method: "POST",
  headers: { "X-LendEasy-Gateway-Signature": gatewaySignature, "Content-Type": "application/json" },
  body: JSON.stringify({
  "gatewayEventRef": "gateway-event-991",
  "eventType": "CUSTOMER_SMS_OPT_OUT",
  "channel": "SMS",
  "occurredAt": "2026-07-25T18: 30:00Z",
  "relatedObjectType": "MESSAGE",
  "relatedObjectRef": "message-71",
  "normalizedStatus": "OPTED_OUT"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/channel-events/{gateway_code}",
  headers={"X-LendEasy-Gateway-Signature": gateway_signature},
  json={
  "gatewayEventRef": "gateway-event-991",
  "eventType": "CUSTOMER_SMS_OPT_OUT",
  "channel": "SMS",
  "occurredAt": "2026-07-25T18: 30:00Z",
  "relatedObjectType": "MESSAGE",
  "relatedObjectRef": "message-71",
  "normalizedStatus": "OPTED_OUT"
},
)

{
  "eventId": 9901,
  "duplicate": false,
  "disposition": "UPDATED"
}

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

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

Path & query parameters

Field	Type	Description
gatewayCode required in path	string	Stable opaque gatewayCode identifier.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/channel-events/$GATEWAY_CODE \
  -H "X-LendEasy-Gateway-Signature: $GATEWAY_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
  "gatewayEventRef": "gateway-event-991",
  "eventType": "CUSTOMER_SMS_OPT_OUT",
  "channel": "SMS",
  "occurredAt": "2026-07-25T18: 30:00Z",
  "relatedObjectType": "MESSAGE",
  "relatedObjectRef": "message-71",
  "normalizedStatus": "OPTED_OUT"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/channel-events/${gatewayCode}`, {
  method: "POST",
  headers: { "X-LendEasy-Gateway-Signature": gatewaySignature, "Content-Type": "application/json" },
  body: JSON.stringify({
  "gatewayEventRef": "gateway-event-991",
  "eventType": "CUSTOMER_SMS_OPT_OUT",
  "channel": "SMS",
  "occurredAt": "2026-07-25T18: 30:00Z",
  "relatedObjectType": "MESSAGE",
  "relatedObjectRef": "message-71",
  "normalizedStatus": "OPTED_OUT"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/channel-events/{gateway_code}",
  headers={"X-LendEasy-Gateway-Signature": gateway_signature},
  json={
  "gatewayEventRef": "gateway-event-991",
  "eventType": "CUSTOMER_SMS_OPT_OUT",
  "channel": "SMS",
  "occurredAt": "2026-07-25T18: 30:00Z",
  "relatedObjectType": "MESSAGE",
  "relatedObjectRef": "message-71",
  "normalizedStatus": "OPTED_OUT"
},
)

{
  "eventId": 9901,
  "duplicate": false,
  "disposition": "UPDATED"
}

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

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