Skip to main content

​
Overview

The SURPLUS_LINES_FILING_ACTION_REQUIRED webhook is triggered when a surplus lines filing checklist item escalation newly transitions into the waiting customer input state — meaning Turris has sent a message on an escalation and is waiting for your response. Webhook type: SURPLUS_LINES_FILING_ACTION_REQUIRED

​
Triggers

This webhook fires when:
  • A Turris admin sends a message on a filing checklist item escalation, setting the turn to the customer (waiting customer input)
This webhook is sent immediately — no debouncing is applied. Each escalation flip is a discrete event requiring prompt customer action.
This webhook fires only when an escalation newly enters the waiting customer input state. It will not fire again for the same escalation until the customer replies (moving it to waiting turris input) and Turris responds again.

​
Payload Example

{
  "webhookType": "SURPLUS_LINES_FILING_ACTION_REQUIRED",
  "upstreamEntityId": "507f1f77bcf86cd799439010",
  "payload": {
    "filingId": "665f1a2b3c4d5e6f7a8b9c0d",
    "externalReference": "POL-2024-00123",
    "policyNumber": "SL-20240601-001",
    "stateCode": "TX",
    "status": "in progress",
    "actionRequired": true,
    "escalationStatus": "waiting customer input",
    "latestEscalationMessage": "Please upload the signed diligent search form for TX."
  }
}

​
Field Reference

​
Payload Fields

FieldTypeDescription
filingIdstringThe Turris ID of the surplus lines filing
externalReferencestring | nullYour external policy reference set when the filing was created, or null if none was provided
policyNumberstringThe policy number on the filing
stateCodestringTwo-letter US state or territory code (e.g., TX)
statusstringCurrent filing status at the time of the event
actionRequiredbooleanAlways true for this event type
escalationStatusstringStatus of the representative open escalation. Always waiting customer input for this event type
latestEscalationMessagestring | nullBody of the most recent message in the escalation thread, or null when no messages have been sent yet