Webhooks

Webhook Callbacks — Overview

This section documents outgoing webhook payloads we send to client endpoints when declaration page is uploaded. Current supported payloads:

• Auto

• Homeowners

Delivery contract

• Method: POST

• Content-Type: application/json

• Retry policy: Exponential backoff, 3 retries by default. See Retry Behavior.

• Idempotency: Each webhook contains policy.policy_type and policy.policy_number entries to correlate events.

Best practices for integrators

1. Always respond 200 OK quickly. If temporary failure occurs, respond with 5xx or timeout; we will retry.

2. Store policy.policy_type and policy.policy_number as your primary key for mapping.

3. Be tolerant of extra fields — payloads may add fields in future versions.

4. Use the downloadable JSON Schema for strict validation.