Download OpenAPI specification:Download
Schema definition for SmarterWX Sentinel Referral Webhook notifications
The subscriber provides a secret key that is used to generate a signature passed in the header of each notification. The receiver can verify that the notification was signed using the provided secret by verifying the X-SWX-Signature header.
The receiver must respond with a 2XX status code within 3 seconds of receiving the notification. If the notification was not succesfully acknowledged, it will be sent again until a successful response is received or the notification times out. The uuid can be used for deduplication purposes.
Endpoint to receive Web Hook notification for referral
X-SWX-Signature required | string Example: sha256=abc123def456ghi789jkl |
Content-Type required | string Example: application/json |
uuid required | string <uuid> Unique identifier for this event |
event required | string Enum: "referral:create" "referral:update" The webhook event trigger |
timestamp required | string <date-time> The timestamp of the original event |
required | object (Referral) |
[- {
- "uuid": "fd07b9f3-dd85-4615-a1e8-8fced35ef2e5",
- "event": "referral:create",
- "timestamp": "2020-08-11T07:44:10Z",
- "message": {
- "id": 234,
- "createdAt": "2020-11-28 06:08:01.000Z",
- "status": "WAITING",
- "sequenceNumber": 300077255,
- "Organisation": {
- "id": 234,
- "name": "Melbourne Water",
- "utilityId": 80010
}, - "Enquiry": {
- "id": 234,
- "createdAt": "2020-11-28 06:08:00.000Z",
- "jobNumber": 40000255,
- "userReference": "Plan Ref AB/123",
- "notes": "I am going to be digging a rather large hole.",
- "digStartAt": "2020-11-29",
- "digEndAt": "2020-11-30",
- "isPlanningJob": false,
- "activityTypes": [
- "MANUAL_EXCAVATION, HORIZ_BORING"
], - "activityTypesLocalized": [
- "Manual Excavation, Horizontal Boring"
], - "authorityType": "Utility",
- "authorityName": "Melbourne Water",
- "locationTypes": [
- "Road Reserve"
], - "locationsInRoad": [
- "Road"
], - "isSandboxTest": false,
- "geometry": { },
- "Address": {
- "id": 123,
- "line1": "613 King St",
- "line2": "Suite 13",
- "locality": "West Melbourne",
- "state": "VIC",
- "postcode": 3003,
- "country": "AUS"
}, - "User": {
- "id": 234,
- "email": "as567sadf.asdf87asdf@relay.smarterwx.com",
- "registeredEmail": "gary@smarterwx.com",
- "firstName": "Ross",
- "lastName": "Noble",
- "phoneNumber": 61444111222,
- "companyName": "Jimmy Diggers",
- "Address": {
- "id": 123,
- "line1": "613 King St",
- "line2": "Suite 13",
- "locality": "West Melbourne",
- "state": "VIC",
- "postcode": 3003,
- "country": "AUS"
}
}
}
}
}
]