Connect

connect_session.updated

Event triggered when a user Leap Connect session is updated. A new session is created when a new Leap Connect tab/window is opened or on the next interaction after an idle session expires (24 hours). The status field options are:

• "CREATED" - user clicks link and reaches initial screen
• "UPDATED" - user moves to next step in the process
• "CLOSED" - user prematurely exits session (e.g. agreement rejected)
• "COMPLETED" - user completes the final step

Example Payload

{
  "webhook_event_id": "cca07005-1406-4539-8b84-1a5f24cd1575",
  "payload": {
    "webhook_event_type": "connect_session.updated",
    "partner_reference": "customer-site-123",
    "status": "CREATED"
  }
}

connect_session.authorization_updated

Event triggered when utility authorization ( Leap Connect utility redirect or CAISO Direct-to-Utility) is updated. The status field options are:

• "INITIATED" - user reaches initial utility login screen
• "COMPLETED" - user completes the utility authorization successfully
• "FAILED" - user encountered an error (e.g. invalid credentials, MFA error, utility error, user cancellation)

Example Payload

{
  "webhook_event_id": "3b41a28a-46b3-4082-b13c-a2f812f1bda5",
  "payload": {
    "webhook_event_type": "connect_session.authorization_updated",
    "partner_reference": "customer-site-123",
    "utility_name": "PGE",
    "status": "INITIATED"
  }
}