Skip to main content

ā€‹
Overview

The SURPLUS_LINES_FILING_STATUS_CHANGE webhook is triggered when the status of a surplus lines filing changes ā€” for example, when Turris moves a filing from In Progress to Filed. Webhook type: SURPLUS_LINES_FILING_STATUS_CHANGE

ā€‹
Triggers

This webhook fires when:
  • A Turris admin updates the status of a surplus lines filing (e.g., from in progress to filed, or from ready to file to completed)
This webhook is sent immediately ā€” no debouncing is applied, since each status change is a discrete event requiring timely awareness.

ā€‹
Payload Example

{
  "webhookType": "SURPLUS_LINES_FILING_STATUS_CHANGE",
  "upstreamEntityId": "507f1f77bcf86cd799439010",
  "payload": {
    "filingId": "665f1a2b3c4d5e6f7a8b9c0d",
    "externalReference": "POL-2024-00123",
    "policyNumber": "SL-20240601-001",
    "stateCode": "TX",
    "status": "filed",
    "actionRequired": false
  }
}

ā€‹
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)
statusstringNew filing status. One of: not started, in progress, ready to file, filed, completed, on hold, canceled
actionRequiredbooleantrue when any checklist item escalation is currently waiting on customer input at the time the status change was recorded