Surplus Lines Filing Action Required

Webhooks belong to the Carrier & MGA API. This event fires about one of your own filings, and only a credential on that surface (carrier, MGA or wholesaler) can subscribe to it.Surplus lines filings are visible on both surfaces, but the subscription is not. An agency can read its own filings through List Surplus-Lines Filings and poll them on a schedule, but it cannot subscribe to this event.

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

Field	Type	Description
`filingId`	string	The Turris ID of the surplus lines filing
`externalReference`	string \| null	Your external policy reference set when the filing was created, or `null` if none was provided
`policyNumber`	string	The policy number on the filing
`stateCode`	string	Two-letter US state or territory code (e.g., `TX`)
`status`	string	Current filing status at the time of the event
`actionRequired`	boolean	Always `true` for this event type
`escalationStatus`	string	Status of the representative open escalation. Always `waiting customer input` for this event type
`latestEscalationMessage`	string \| null	Body of the most recent message in the escalation thread, or `null` when no messages have been sent yet

Start Here

Shared Endpoints

Products

Agencies You Appoint

Contract Container Templates

Agents

Contacts

Market Contacts

Licenses

Appointments

Compliance Data Subscriptions

Compliance Status

File Documents

Policy Ingestion

Policy Transactions

Surplus Lines Filings

Webhooks

E&O/Cyber Compliance

Regulatory Actions

Tools

Surplus Lines Filing Action Required

Overview

Triggers

Payload Example

Field Reference

Payload Fields

​Overview

​Triggers

​Payload Example

​Field Reference

​Payload Fields

Overview

Triggers

Payload Example

Field Reference

Payload Fields