Webhooks

Webhooks allow external systems to receive real-time notifications from Visualogyx when certain events occur. When triggered, a POST request is sent to your specified endpoint URL with a structured payload.

Note: Webhooks are not enabled by default. To get access, contact us to request activation for your organization.


Supported Events

Event NameDescription
inspection.status.updatedTriggered when an inspection’s status is changed
inspection.status.completedTriggered when an inspection is marked complete

How to Create a Webhook

  1. In the Web Application, go to SettingsDeveloperWebhooks.
  2. Click Add Webhook.
  3. Fill in:
    • Name – Internal name for the webhook
    • Events – One or more supported events
    • Endpoint – HTTPS URL to receive the webhook

Sample Payloads

inspection.status.updated`

{
  "status_code": 200,
  "event_payload": {
    "event": "inspection.status.updated",
    "timestamp": "2024-04-04T12:00:00Z",
    "webhook": {
      "id": "",
      "name": "webhook name",
      "url": "endpoint"
    },
    "metadata": "{\\\"IPAddress\\\": \\\"123.456.789.101\\\", \\\"Browser\\\":\\\"Chrome\\\", \\\"Referrer\\\":\\\"<https://example.com/signup>\\\"}",
    "data": {
      "type": "inspection",
      "object": {
        //Inspection object
      }
    }
  }
} 

inspection.status.completed`

{  
  "status_code": 200,  
  "event_payload": {  
    "event": "inspection.status.completed",  
    "timestamp": "2024-04-04T12:00:00Z",  
    "webhook": {  
      "id": "",  
      "name": "webhook name",  
      "url": "endpoint"  
    },  
    "metadata": "{\\\"IPAddress\\\": \\\"123.456.789.101\\\", \\\"Browser\\\":\\\"Chrome\\\", \\\"Referrer\\\":\\\"<https://example.com/signup>\\\"}",  
    "data": {  
      "type": "inspection",  
      "object": {
        // Inspection object
      }  
    }  
  }  
} 

Delivery & Retry Logic

If your endpoint is temporarily unavailable or does not respond with a 2xx status code, we will retry delivery a few times over a short interval. We do not currently support custom retry configuration or delivery status tracking.