Meter

meter.created

Event triggered when a new meter is created in your account. Event will be emitted if a meter was partner-created (Create Meters API, Meter Upload in Portal) as well as customer-authorized (Leap Connect).

{
  "webhook_event_id": "26c8b7c6-3d3c-4d84-9ce9-734930c897d4",
  "payload": {
    "webhook_event_type": "meter.created",
    "meter_id": "11111111-1111-1111-1111-111111111111",
    "partner_reference": "customer-site-123",
    "transmission_region": "CAISO",
    "meter_type": "UTILITY_METER"
  }
}

meter.enrollment.global-status.updated

Event triggered when the global enrollment status on a meter changes.

{
  "webhook_event_id": "94306cf3-9498-4df9-97b7-092c0233d68f",
  "payload": {
    "webhook_event_type": "meter.enrollment.global-status.updated",
    "global_enrollment_status": "ELIGIBLE",
    "meter_id": "11111111-1111-1111-1111-111111111111",
    "partner_reference": "customer-site-123",
    "transmission_region": "CAISO",
    "meter_type": "UTILITY_METER"
  }
}

meter.enrollment.required-actions.updated

Event triggered for any new or updated partner actions on a meter. This includes new actions added, existing actions updated, or existing actions resolved. Once all partner actions on a meter are resolved, a new event will be triggered with an empty required_actions array: "required_actions": {}.

{
  "webhook_event_id": "fe20d8a3-c14d-4154-b082-1477d1cd406d",
  "payload": {
    "webhook_event_type": "meter.enrollment.required-actions.updated",
    "meter_id": "11111111-1111-1111-1111-111111111111",
    "transmission_region": "CAISO",
    "required_actions": {
      "partner": [
        {
          "enrollment_deadline_date_time": "2026-04-15T07:00:00Z",
          "action_type": "NO_MISSING_FIELDS",
          "action_description": "Partner needs configuration for fields: Battery Energy Capacity, Battery Power Capacity, Number Of Devices.",
          "action_code": "SERV_0005",
          "program_identifier": "CEC-DSGS",
          "delivery_period": "CEC-DSGS_2026_MAY_OCT"
        }
      ]
    },
    "global_enrollment_status": "INELIGIBLE",
    "partner_reference": "customer-site-123",
    "meter_type": "DEVICE"
  }
}

meter.enrollment.participation-status.updated

Event triggered when the partner participation preference (PARTICIPATE, IDLE, DISENROLL) on a meter changes.

{
  "webhook_event_id": "d4eb0f28-2285-44d9-8b61-00388194f74a",
  "payload": {
    "webhook_event_type": "meter.enrollment.participation-status.updated",
    "participation_preference": "PARTICIPATE",
    "start_time": "2026-05-01T00:00:00Z",
    "meter_id": "11111111-1111-1111-1111-111111111111",
    "partner_reference": "partner-reference-1",
    "transmission_region": "CAISO",
    "meter_type": "UTILITY_METER"
  }
}

meter.enrollment.group.updated

Event triggered whenever the start date, end date, or list of meter IDs in a VPP market group changes.

📘
Only Use If Dispatching In Pre-Configured Groups
If your device management platform must dispatch in pre-configured groups, it is essential that you keep your inventory in sync. Dispatching a group with outdated group assignments can cause poor dispatch performance and reduce grid services revenues.

{
  "webhook_event_id": "e7e9e580-6a60-4164-8d7f-57f8f1e2aec6",
  "payload": {
    "webhook_event_type": "meter.enrollment.group.updated",
    "market_group_id": "35d51310-cc2c-47d1-9e24-d5514076ff04",
    "market_group_name": "GRP1_NAME",
    "start_date_time": "2026-05-01T07:00:00Z",
    "end_date_time": "2024-06-01T07:00:00Z",
    "meter_ids": [
      "11111111-1111-1111-1111-111111111111",
      "22222222-2222-2222-2222-222222222222"
    ]
  }
}