Webhook Events

Use webhooks to get notified when activity happens in Wunderite.

Webhook Payloads

All webhook events share the same top-level payload shape:

Name
event
Type
string
Description
The event name. See all available events below.
Name
timestamp
Type
timestamp
Description
The timestamp when the event took place
Name
team
Type
string
Description
The UUID of the Wunderite agency the event took place in
Name
data
Type
object
Description
Each event implements a different data blob, see them below in available events
Name
meta
Type
nullable object
Description
Additional information that is included in the webhook, see each available event for more information

Meta Properties

When an agency has AMS360 enabled (denoted with AMS360 Meta), certain events will include additional AMS360-specific properties in the meta object. These properties help identify the relevant AMS360 entities associated with the event. The following properties will be included in the meta object:

Name
external_ids.ams360_agency_id
Type
string
Description
The AMS360 agency ID
Name
external_ids.ams360_customer_guid
Type
string
Description
The AMS360 customer GUID

Example payload

{
  "event": "form.completed",
  "timestamp": "2026-01-13T20:46:47+00:00",
  "team": "fc8fd97e-4783-4201-8fde-291100264558",
  "data": {...},
  "meta": {
    "external_ids": {
      "ams360_agency_id": "123456",
      "ams360_customer_guid": "abcd-efgh-ijkl-mnop"
    }
  }
}

Webhook Resources

Webhook events follow consistent resource structures for common objects. Webhooks follow the principle of including only the necessary data for each event, so not all properties of a resource may be present in every event.

Below are the common webhook resources used in various events.

Risk Profile Webhook Resource

Name
uuid
Type
string
Description
The unique identifier for the risk profile
Name
name
Type
string
Description
The name of the risk profile
Name
profile_type
Type
string[]
Description
The risk profile type, an array of commercial, personal

Example payload

{
  "uuid": "d10e34bb-4420-47de-ba9f-42a4a3f34b0e",
  "name": "Pied Piper",
  "profile_type": [
    "commercial"
  ]
}

User Webhook Resource

Name
uuid
Type
string
Description
The unique identifier for the user
Name
role
Type
string
Description
The role of the user, either agent or customer
Name
name
Type
string
Description
The name of the user
Name
email
Type
string
Description
The email of the user

Example payload

{
  "uuid": "a1b2c3d4-e5f6-4789-abcd-ef0123456789",
  "role": "agent",
  "name": "Admin Account",
  "email": "[email protected]"
}

Available Events

form.completed
signature_packet.completed

`form.completed`

AMS360 Meta

Triggered when a form within a risk profile has been completed.

Name
risk_profile
Type
Risk Profile
Description
The risk profile that the form belongs to
Name
questionnaire.uuid
Type
string
Description
The unique identifier for the questionnaire that the form is a copy of
Name
questionnaire.title
Type
string
Description
The title of the questionnaire that the form is a copy of
Name
form.uuid
Type
string
Description
The unique identifier for the form
Name
form.friendly_name
Type
string
Description
The name of the form as it appears in the risk profile
Name
form.download_url
Type
nullable string
Description
The URL to download the flattened PDF for the form, if the form has a PDF or attachments. The download URL is valid for 24 hours.
Name
form.url
Type
string
Description
The URL to the form in the Wunderite UI
Name
completed_by
Type
User
Description
The user who completed the form

Example payload

{
  "event": "form.completed",
  "timestamp": "2026-01-14T17:19:12+00:00",
  "data": {
    "risk_profile": {
      "uuid": "d10e34bb-4420-47de-ba9f-42a4a3f34b0e",
      "name": "Pied Piper",
      "profile_type": [
        "commercial"
      ]
    },
    "questionnaire": {
      "uuid": "4e8df9c8-d004-48d8-96b4-5c992ce03045",
      "title": "Markel: Trucking Supplemental Application"
    },
    "form": {
      "uuid": "12a5bf7b-fc1b-40ee-8b5c-0c62fd83eca4",
      "friendly_name": "Markel: Trucking Supplemental Application",
      "download_url": "https://app.wunderite.com/api/files/forms/12a5bf7b-fc1b-40ee-8b5c-0c62fd83eca4?expires=1768497555&flattened=1&signature=8bf1d4bf6903948a860cff30422c51ab59754713fdfb403f53b2a81afeeb058f&attachments=1",
      "url": "https://app.wunderite.com/risk-profiles/d10e34bb-4420-47de-ba9f-42a4a3f34b0e/forms/12a5bf7b-fc1b-40ee-8b5c-0c62fd83eca4"
    },
    "completed_by": {
      "uuid": "a1b2c3d4-e5f6-4789-abcd-ef0123456789",
      "role": "agent",
      "name": "Admin Account",
      "email": "[email protected]"
    }
  },
  "team": "fc8fd97e-4783-4201-8fde-291100264558"
}

`signature_packet.completed`

AMS360 Meta

Triggered when a signature packet has had all of its forms signed by all applicable signers.

Name
risk_profile
Type
Risk Profile
Description
The risk profile that the signature packet belongs to
Name
signature_packet.uuid
Type
string
Description
The unique identifier of the packet
Name
signature_packet.title
Type
string
Description
The title of the packet
Name
signature_packet.forms
Description
A list of forms within the signature packet
Name
signature_packet.forms.*.uuid
Type
string
Description
The unique identifier for the form within the packet
Name
signature_packet.forms.*.title
Type
string
Description
The name of the individual form within the packet
Name
signature_packet.forms.*.download_url
Type
string
Description
The URL to download the PDF for the form. The download URL is valid for 24 hours.
Name
signature_packet.forms.*.completed_at
Type
string
Description
The timestamp that the form was completed
Name
signature_packet.forms.*.signers
Type
User[]
Description
A list of users who are a signer on the form
Name
signature_packet.signers
Type
User[]
Description
A complete list of users who are a signer on any form in the packet
Name
completed_by
Type
User
Description
The user who completed the packet

Example payload

{
  "event": "signature_packet.completed",
  "timestamp": "2026-01-15T14:51:13+00:00",
  "data": {
    "risk_profile": {
      "uuid": "d10e34bb-4420-47de-ba9f-42a4a3f34b0e",
      "name": "Pied Piper",
      "profile_type": [
        "commercial"
      ]
    },
    "signature_packet": {
      "uuid": "975b2e54-32cb-40c3-90d1-053395694e72",
      "title": "Tokio Marine HCC: TechGuard Cyber Liability Insurance Application",
      "forms": [
        {
          "uuid": "7d4f0501-2002-4149-b14a-5c309118f0fc",
          "title": "Tokio Marine HCC: TechGuard Cyber Liability Insurance Application",
          "download_url": "https://s3.amazonaws.com/wunderite-signed-docs/f774dc33fecba83e736c0e4cd640408c/tokio_marine_hcc_techguard_cyber_liability_insurance_application_flat.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=sail%2F20260115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260115T145117Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Signature=6f9cdc0818263ded48abb88111424dd7a2d16d362e5b0f5af2b16783ee33112d",
          "completed_at": "2026-01-15T14:51:10+00:00",
          "signers": [
            {
              "uuid": "aa58abc5-9f59-4af7-b52b-83135246acad",
              "name": "Admin Account",
              "email": "[email protected]",
              "role": "agent"
            },
            {
              "uuid": "55ad55a2-d65e-4635-931f-36c8ba8e5c1b",
              "name": "Agent Account",
              "email": "[email protected]",
              "role": "agent"
            }
          ]
        }
      ],
      "signers": [
        {
          "uuid": "aa58abc5-9f59-4af7-b52b-83135246acad",
          "name": "Admin Account",
          "email": "[email protected]",
          "role": "agent"
        },
        {
          "uuid": "55ad55a2-d65e-4635-931f-36c8ba8e5c1b",
          "name": "Agent Account",
          "email": "[email protected]",
          "role": "agent"
        }
      ],
      "completed_by": {
        "uuid": "aa58abc5-9f59-4af7-b52b-83135246acad",
        "name": "Admin Account",
        "email": "[email protected]",
        "role": "agent"
      },
    }
  },
  "team": "fc8fd97e-4783-4201-8fde-291100264558"
}