Nectar Webhook Event Types
This is the list of event types that we currently send.
For guidance on how to listen to these events, take a look at Svix's guide to consuming webhooks.
connection.created
Pushes an event when a utility account connection is created.
Example
JSON
{
"accounts": [
{
"accountNumber": "string",
"datasourceTypes": [
"string"
],
"endDate": "2025-05-10",
"isTracked": true,
"startDate": "2025-05-10"
}
],
"company": {
"externalId": "string",
"id": "347b367d-ae6e-42cb-b998-3e7fb9ec6d58",
"name": "string"
},
"country": "string",
"created": "2025-05-10T00:41:17.398683402",
"datasource": {
"name": "string"
},
"emails": [
"email"
],
"eventType": "string",
"id": "a7685b41-39c2-4fd1-aceb-f99198ffeaf5",
"status": "string",
"updated": "2025-05-10T00:41:17.398693003",
"url": "string"
}connection.created.v2
Pushes an event when a utility account connection is created. V2 format with enhanced data.
Example
JSON
{
"accounts": [
{
"accountNumber": "string",
"dataCollectionStartDate": "2025-07-09",
"datasourceTypes": [
"string"
],
"id": "31e50595-b27d-4b8a-bc42-6621168a219e",
"isCollectingInvoiceData": true,
"isCollectingSmartMeterData": true,
"isDuplicated": true,
"isTracked": true,
"meters": [
"a80c5eda-0a72-4353-9cf9-016be1f7378d"
]
}
],
"country": "string",
"created": "2025-07-09T03:39:51.461608569",
"dataCollectionStartDate": "2025-07-09",
"eventType": "string",
"id": "b7798240-ed37-4b2f-85b2-993c00b81f37",
"initialSites": [
"06b1f7bf-8e29-44b6-a8bb-2503506906ca"
],
"multiplyByOccupancy": true,
"status": "string",
"updated": "2025-07-09T03:39:51.461618819",
"url": "string",
"username": "string",
"workflowOwnerEmail": "email"
}connection.updated
Pushes an event when a utility account connection is updated.
Example
JSON
{
"accounts": [
{
"accountNumber": "string",
"datasourceTypes": [
"string"
],
"endDate": "2025-05-10",
"isTracked": true,
"startDate": "2025-05-10"
}
],
"company": {
"externalId": "string",
"id": "b492a1a8-4a95-4fd1-a80e-74acf4ca006d",
"name": "string"
},
"country": "string",
"created": "2025-05-10T00:41:17.399085912",
"datasource": {
"name": "string"
},
"emails": [
"email"
],
"eventType": "string",
"id": "b0b935f9-cf91-4da7-b0b3-86d665532608",
"protectedChanges": [],
"status": "string",
"updated": "2025-05-10T00:41:17.399093962",
"url": "string"
}connection.updated.v2
Pushes an event when a utility account connection is updated. V2 format with enhanced data.
Example
JSON
{
"accounts": [
{
"accountNumber": "string",
"dataCollectionStartDate": "2025-07-09",
"datasourceTypes": [
"string"
],
"id": "0092536f-e15d-4d08-b9e5-1489aaca96cd",
"isCollectingInvoiceData": true,
"isCollectingSmartMeterData": true,
"isDuplicated": true,
"isTracked": true,
"meters": [
"94700c0d-5da5-423a-8c9f-a13c7dd3032d"
]
}
],
"country": "string",
"created": "2025-07-09T03:39:51.461931140",
"dataCollectionStartDate": "2025-07-09",
"eventType": "string",
"id": "e759c983-58bb-40dc-8a91-c1c34fd00fb8",
"initialSites": [
"5999b46a-e0f5-4b50-a94a-b82bfa8d55fb"
],
"multiplyByOccupancy": true,
"protectedChanges": [],
"status": "string",
"updated": "2025-07-09T03:39:51.461960410",
"url": "string",
"username": "string",
"workflowOwnerEmail": "email"
}connection.validated
Pushes an event when a utility account connection is updated or validated by the Nectar system.
Example
JSON
{
"accounts": [
{
"accountNumber": "string",
"datasourceTypes": [
"string"
],
"endDate": "2025-05-10",
"isTracked": true,
"startDate": "2025-05-10"
}
],
"company": {
"externalId": "string",
"id": "c559fcfe-3b78-47a1-acfb-55a2880518fa",
"name": "string"
},
"country": "string",
"created": "2025-05-10T00:41:17.399683496",
"datasource": {
"name": "string"
},
"emails": [
"email"
],
"eventType": "string",
"id": "73ca7bb7-5f5c-48c2-ac24-db17cc09f221",
"protectedChanges": [],
"status": "string",
"updated": "2025-05-10T00:41:17.399690926",
"url": "string"
}connection.validated.v2
Pushes an event when a utility account connection is validated. V2 format with enhanced data.
Example
JSON
{
"accounts": [
{
"accountNumber": "string",
"dataCollectionStartDate": "2025-07-09",
"datasourceTypes": [
"string"
],
"id": "f2bb7dab-2eea-4ec2-9280-4325662a70f3",
"isCollectingInvoiceData": true,
"isCollectingSmartMeterData": true,
"isDuplicated": true,
"isTracked": true,
"meters": [
"cd327338-8617-4639-bbb5-6f4d48380c6a"
]
}
],
"country": "string",
"created": "2025-07-09T03:39:51.462368591",
"dataCollectionStartDate": "2025-07-09",
"eventType": "string",
"id": "8d590554-1966-4120-b556-a70257ea355c",
"initialSites": [
"28d5f527-e36d-49b0-b677-10f265847173"
],
"multiplyByOccupancy": true,
"protectedChanges": [],
"status": "string",
"updated": "2025-07-09T03:39:51.462395911",
"url": "string",
"username": "string",
"workflowOwnerEmail": "email"
}document.created
Pushes an event when a document is created.
Example
JSON
{
"afterPreviousCharges": "decimal",
"afterPreviousCredits": "decimal",
"afterPreviousTotalPayment": "decimal",
"auditTrailUrl": "string",
"chargesUnits": "string",
"company": {
"externalId": "string",
"id": "4ee0cb09-f4ce-4fa9-8722-d102afc161fa",
"name": "string"
},
"created": "2025-05-10T00:41:17.399982233",
"credits": "decimal",
"currentCharges": "decimal",
"currentOpenBalance": "decimal",
"documentDate": "2025-05-10",
"dueDate": "2025-05-10",
"electricityDeliveryCharges": "decimal",
"electricityDemandCharges": "decimal",
"electricitySupplyCharges": "decimal",
"eventType": "string",
"gasDeliveryCharges": "decimal",
"gasSupplyCharges": "decimal",
"id": "9673acab-8c19-4ff0-9c75-1029079263f8",
"interestCharges": "decimal",
"invoiceId": "string",
"isFlagged": true,
"lineItems": [
{
"accountIds": [
"string"
],
"billingPeriod": "string",
"chargeType": "string",
"description": "string",
"electricityChargeType": "string",
"electricityIsDemand": true,
"electricityTimeOfUse": "string",
"gasChargeType": "string",
"meterIds": [
"string"
],
"multipliers": [
"decimal"
],
"quantity": "decimal",
"quantityUnits": "string",
"rate": "decimal",
"totalCharge": "decimal"
}
],
"meterSiteUsageData": [
{
"accountId": "string",
"accountIsTracked": true,
"additionalFields": {},
"auditTrailUrl": "string",
"billedDemand": "decimal",
"created": "2025-05-10T00:41:17.400026715",
"currentReading": "decimal",
"customContainerName": "string",
"customContainerSize": "decimal",
"customContainerUnits": "string",
"customContainerUsage": "decimal",
"datasourceType": "string",
"daysInRange": 42,
"documentDate": "2025-05-10",
"documentId": "ee1fbd0a-7bc4-474c-b986-7384ea9138a7",
"documentNotes": "string",
"documentSourceType": "string",
"endDate": "2025-05-10",
"exclusion": true,
"icp": "string",
"id": "7c3a7372-8ec4-4a52-aeea-fb4bf1fad811",
"identifiers": [
{
"name": "string",
"value": "string"
}
],
"isEstimated": true,
"isFlagged": true,
"isImplied": true,
"meterId": "string",
"podId": "string",
"previousReading": "decimal",
"processedDate": "2025-05-10T00:41:17.400049665",
"shopNumber": "string",
"siteAddress": "string",
"siteExternalId": "string",
"siteId": "0e0fa7dc-aa3f-4394-a05f-db22e113db83",
"siteName": "string",
"startDate": "2025-05-10",
"submeterId": "string",
"supplierName": "string",
"tariff": "string",
"totalDocumentCharges": "decimal",
"totalDocumentChargesUnits": "string",
"updated": "2025-05-10T00:41:17.400063215",
"usage": "string",
"usageUnits": "string",
"utilityCompany": "string"
}
],
"notes": "string",
"previousCloseBalance": "decimal",
"processedDate": "2025-05-10T00:41:17.400079966",
"revisedDocumentId": "string",
"sourceType": "string",
"supersededDocumentIds": [
"string"
],
"taxCharges": "decimal",
"totalCharges": "decimal",
"url": "string",
"utilityCompany": "string"
}document.created.v2
Pushes an event when a document is created. V2 format with enhanced data.
Example
JSON
{
"afterPreviousCharges": "decimal",
"afterPreviousCredits": "decimal",
"afterPreviousTotalPayment": "decimal",
"auditTrailUrl": "string",
"billDate": "2025-07-09",
"chargesUnits": "string",
"company": "72180474-26c9-48a5-8d76-185a3fca8ef3",
"created": "2025-07-09T03:39:51.462751983",
"credits": "decimal",
"currentCharges": "decimal",
"currentOpenBalance": "decimal",
"dueDate": "2025-07-09",
"electricityDeliveryCharges": "decimal",
"electricityDemandCharges": "decimal",
"electricitySupplyCharges": "decimal",
"email": "email",
"eventType": "string",
"fileName": "string",
"gasDeliveryCharges": "decimal",
"gasSupplyCharges": "decimal",
"id": "322a2a7f-ad04-4844-9bb8-19a011f0bbe4",
"interestCharges": "decimal",
"invoiceId": "string",
"isFlagged": true,
"jobId": "string",
"lineItems": [
{
"accountIds": [
"string"
],
"description": "string",
"electricityIsDemand": true,
"electricityTimeOfUse": "string",
"multipliers": [
"decimal"
],
"quantity": "decimal",
"quantityUnits": "string",
"rate": "decimal",
"totalCharge": "decimal"
}
],
"notes": "string",
"previousCloseBalance": "decimal",
"revisedDocumentId": "string",
"sourceType": "string",
"supersededDocumentIds": [
"string"
],
"taxCharges": "decimal",
"totalCharges": "decimal",
"updated": "2025-07-09T03:39:51.462793473",
"url": "string",
"usageData": [
{
"additionalFields": {},
"billedDemand": "decimal",
"country": "string",
"created": "2025-07-09T03:39:51.462846093",
"currentReading": "decimal",
"datasourceType": "string",
"districtMediumType": "string",
"districtType": "string",
"endDate": "2025-07-09",
"exclusion": true,
"fractionRenewable": "decimal",
"fuelType": "string",
"gasType": "string",
"id": "4bda1cb4-94b3-4b0a-af9d-ba834598950b",
"identifiers": [
{
"name": "string",
"rawName": "string",
"value": "string"
}
],
"isEstimated": true,
"isImplied": true,
"meter": "string",
"meterHighLow": "string",
"meterIsTracked": true,
"multiplier": "decimal",
"multiplier2": "decimal",
"multiplier2Description": "string",
"multiplierDescription": "string",
"netMeteringGeneratedKwh": "decimal",
"netMeteringGridExportKwh": "decimal",
"netMeteringGridImportKwh": "decimal",
"netMeteringType": "string",
"previousReading": "decimal",
"refrigerantType": "string",
"serviceAddress": "string",
"startDate": "2025-07-09",
"supplierName": "string",
"tariff": "string",
"timeOfUse": "string",
"updated": "2025-07-09T03:39:51.462866783",
"usage": "string",
"wasteDescription": "string",
"wasteStream": "string",
"wasteType": "string",
"waterType": "string"
}
],
"utilityCompany": "string"
}document.updated
Pushes an event when a document is updated.
Example
JSON
{
"afterPreviousCharges": "decimal",
"afterPreviousCredits": "decimal",
"afterPreviousTotalPayment": "decimal",
"auditTrailUrl": "string",
"chargesUnits": "string",
"company": {
"externalId": "string",
"id": "e9a82440-66e9-486a-90f7-4054e53ef793",
"name": "string"
},
"created": "2025-05-10T00:41:17.402149345",
"credits": "decimal",
"currentCharges": "decimal",
"currentOpenBalance": "decimal",
"documentDate": "2025-05-10",
"dueDate": "2025-05-10",
"electricityDeliveryCharges": "decimal",
"electricityDemandCharges": "decimal",
"electricitySupplyCharges": "decimal",
"eventType": "string",
"gasDeliveryCharges": "decimal",
"gasSupplyCharges": "decimal",
"id": "d730cd17-75a7-4ff4-8af0-850461749301",
"interestCharges": "decimal",
"invoiceId": "string",
"isFlagged": true,
"lineItems": [
{
"accountIds": [
"string"
],
"billingPeriod": "string",
"chargeType": "string",
"description": "string",
"electricityChargeType": "string",
"electricityIsDemand": true,
"electricityTimeOfUse": "string",
"gasChargeType": "string",
"meterIds": [
"string"
],
"multipliers": [
"decimal"
],
"quantity": "decimal",
"quantityUnits": "string",
"rate": "decimal",
"totalCharge": "decimal"
}
],
"meterSiteUsageData": [
{
"accountId": "string",
"accountIsTracked": true,
"additionalFields": {},
"auditTrailUrl": "string",
"billedDemand": "decimal",
"created": "2025-05-10T00:41:17.402195166",
"currentReading": "decimal",
"customContainerName": "string",
"customContainerSize": "decimal",
"customContainerUnits": "string",
"customContainerUsage": "decimal",
"datasourceType": "string",
"daysInRange": 42,
"documentDate": "2025-05-10",
"documentId": "3ca0b273-3de6-480d-b751-109218be3584",
"documentNotes": "string",
"documentSourceType": "string",
"endDate": "2025-05-10",
"exclusion": true,
"icp": "string",
"id": "b6091ede-7e9e-422e-9335-277c98d94c4f",
"identifiers": [
{
"name": "string",
"value": "string"
}
],
"isEstimated": true,
"isFlagged": true,
"isImplied": true,
"meterId": "string",
"podId": "string",
"previousReading": "decimal",
"processedDate": "2025-05-10T00:41:17.402217447",
"shopNumber": "string",
"siteAddress": "string",
"siteExternalId": "string",
"siteId": "8be64e22-8b82-484b-97b5-6ae04778874d",
"siteName": "string",
"startDate": "2025-05-10",
"submeterId": "string",
"supplierName": "string",
"tariff": "string",
"totalDocumentCharges": "decimal",
"totalDocumentChargesUnits": "string",
"updated": "2025-05-10T00:41:17.402230587",
"usage": "string",
"usageUnits": "string",
"utilityCompany": "string"
}
],
"notes": "string",
"previousCloseBalance": "decimal",
"processedDate": "2025-05-10T00:41:17.402248308",
"revisedDocumentId": "string",
"sourceType": "string",
"supersededDocumentIds": [
"string"
],
"taxCharges": "decimal",
"totalCharges": "decimal",
"url": "string",
"utilityCompany": "string"
}document.updated.v2
Pushes an event when a document is updated. V2 format with enhanced data.
Example
JSON
{
"afterPreviousCharges": "decimal",
"afterPreviousCredits": "decimal",
"afterPreviousTotalPayment": "decimal",
"auditTrailUrl": "string",
"billDate": "2025-07-09",
"chargesUnits": "string",
"company": "a08eb70c-803d-4569-8b20-09a375760279",
"created": "2025-07-09T03:39:51.464429408",
"credits": "decimal",
"currentCharges": "decimal",
"currentOpenBalance": "decimal",
"dueDate": "2025-07-09",
"electricityDeliveryCharges": "decimal",
"electricityDemandCharges": "decimal",
"electricitySupplyCharges": "decimal",
"email": "email",
"eventType": "string",
"fileName": "string",
"gasDeliveryCharges": "decimal",
"gasSupplyCharges": "decimal",
"id": "21f400ee-8423-4485-a0c5-d91ff00c6705",
"interestCharges": "decimal",
"invoiceId": "string",
"isFlagged": true,
"jobId": "string",
"lineItems": [
{
"accountIds": [
"string"
],
"description": "string",
"electricityIsDemand": true,
"electricityTimeOfUse": "string",
"multipliers": [
"decimal"
],
"quantity": "decimal",
"quantityUnits": "string",
"rate": "decimal",
"totalCharge": "decimal"
}
],
"notes": "string",
"previousCloseBalance": "decimal",
"revisedDocumentId": "string",
"sourceType": "string",
"supersededDocumentIds": [
"string"
],
"taxCharges": "decimal",
"totalCharges": "decimal",
"updated": "2025-07-09T03:39:51.464522409",
"url": "string",
"usageData": [
{
"additionalFields": {},
"billedDemand": "decimal",
"country": "string",
"created": "2025-07-09T03:39:51.464574389",
"currentReading": "decimal",
"datasourceType": "string",
"districtMediumType": "string",
"districtType": "string",
"endDate": "2025-07-09",
"exclusion": true,
"fractionRenewable": "decimal",
"fuelType": "string",
"gasType": "string",
"id": "2587ca93-55c2-4953-8474-ff9bc94c571c",
"identifiers": [
{
"name": "string",
"rawName": "string",
"value": "string"
}
],
"isEstimated": true,
"isImplied": true,
"meter": "string",
"meterHighLow": "string",
"meterIsTracked": true,
"multiplier": "decimal",
"multiplier2": "decimal",
"multiplier2Description": "string",
"multiplierDescription": "string",
"netMeteringGeneratedKwh": "decimal",
"netMeteringGridExportKwh": "decimal",
"netMeteringGridImportKwh": "decimal",
"netMeteringType": "string",
"previousReading": "decimal",
"refrigerantType": "string",
"serviceAddress": "string",
"startDate": "2025-07-09",
"supplierName": "string",
"tariff": "string",
"timeOfUse": "string",
"updated": "2025-07-09T03:39:51.464595289",
"usage": "string",
"wasteDescription": "string",
"wasteStream": "string",
"wasteType": "string",
"waterType": "string"
}
],
"utilityCompany": "string"
}