List Of Webhook Events

Types of Events

This is a list of all the types of events we currently send. We may add more at any time, so in developing and maintaining your code, you should not assume that only these types exist.

eDRV follows the best industry practices and you will notice that these events follow a pattern: resource.event. Our goal is to design a consistent system that makes things easier to anticipate and code against.

There are four types of Webhooks sent by eDRV:

  1. Network Events Events triggered by activity on the network.
    E.g. a chargestation going offline
    Format: resource.event

  2. Actions Events that report the states of a command sent to the chargestation.
    E.g. a chargestation change configuration request
    Format: action_name.status

  3. Synchronous Events Events in response to adding / editing data on eDRV.
    E.g. adding a connector on eDRV
    Format: resource.event

  4. Charging Intelligence Events Events triggered by eDRV's charging intelligence.
    E.g. when a session's target energy value has been reached
    Format: resource.event

Network Events

These are Asynchronous events triggered by network activity, for e.g. when a driver plugs in a cable.

Chargestation Webhooks

chargestation.online data is a Chargestation
Whenever a charge station connects to eDRV. This event is FIFO ordered per chargestation.

chargestation.offline data is a Chargestation
Whenever a charge station loses connection to eDRV. This event is FIFO ordered per chargestation.

chargestation.connector_status.updated data is a Chargestation with Connector objects in an array.
Whenever the status of a connector changes. The status in the connector object contains the reported connector state e.g. "Preparing" when a driver successfully plugs in a cable.

Session Webhooks

session.updated data is a Session
Occurs whenever a session field is updated. E.g. when the chargestation reports a new energy readings via the session.metrics or the session.energy_report field. This event is FIFO ordered per chargestation.

session.started data is a Session
Occurs whenever the chargestation sends a charging start event and confirms that an energy transaction has begun. This event is FIFO ordered per chargestation.

session.ended data is a Session
Occurs whenever the chargestation confirms that an energy transaction has stopped.This event is FIFO ordered per chargestation.

session.cancelled data is a Session
Occurs whenever a session was cancelled. E.g. due to a failure to plug in the cable within time.

session.start_failure data is a Session
Occurs when the chargestation was unable to start the session.

session.stop_failure data is a Session
Occurs when the chargestation was unable to stop the session.

Webhooks for Actions

The format is Action.Status.
Status can be in one of three states:
requested: The request has been sent to the chargestation
accepted: The chargestation accepted the request. Please see the response object for any data returned
rejected: The chargestation rejected the request. See response data for any error details reported by the chargestation

session.set_power_limit.requested / accepted / rejected data is an Action
Occurs when reporting a set_power_limit action on a session. This event is FIFO ordered per chargestation.

session.clear_power_limit.requested / accepted / rejected data is an Action
Occurs when reporting a clear_power_limit action on a session. This event is FIFO ordered per chargestation.

connector.set_power_limit.requested / accepted / rejected data is an Action
Occurs when reporting a set_power_limit action on a connector. This event is FIFO ordered per chargestation.

connector.clear_power_limit.requested / accepted / rejected data is an Action
Occurs when reporting a clear_power_limit action on a connector. This event is FIFO ordered per chargestation.

chargestation.set_power_limit.requested / accepted / rejected data is an Action
Occurs when reporting a set_power_limit action on a chargestation or connector. This event is FIFO ordered per chargestation.

chargestation.clear_power_limit.requested / accepted / rejected data is an Action
Occurs when reporting a clear_power_limit action on a chargestation or connector. This event is FIFO ordered per chargestation.

chargestation.get_configuration.requested / accepted / rejected data is an Action
Occurs when fetching chargestation configurations via an API call.

Note: Please use GET /chargestations/{id}/configurations request to see the full response.

chargestation.update_configuration.requested / accepted / rejected data is an Action
Occurs when updating a chargestation configuration via an API call.

chargestation.trigger_message.requested / accepted / rejected data is an Action

Occurs when a trigger_message action is sent via an API call.

chargestation.get_local_list_version.requested / accepted / rejecteddata is an Action

Occurs when fetching the get_local_list_version via an API call.

chargestation.send_local_list.requested / accepted / rejected data is an Action

Occurs when a send_local_list action is sent via an API call.

chargestation.get_composite_schedule.requested / accepted / rejected data is an Action

Occurs when fetching get_composite_schedule via an API call.

chargestation.set_charging_profile.requested / accepted / rejected data is an Action

Occurs when a set_charging_profile action is sent via an API call. This event is FIFO ordered per chargestation.

chargestation.clear_charging_profile.requested / accepted / rejected data is an Action

Occurs when a clear_charging_profile action is sent via an API call. This event is FIFO ordered per chargestation.

chargestation.get_diagnostics.requested / accepted / rejecteddata is an Action

Occurs when a get_diagnostics action is sent via an API call or dashboard. This event is FIFO ordered per chargestation.

chargestation.update_firmware.requested / accepted / rejecteddata is an Action

Occurs when an update_firmware action is sent via an API call or dashboard.

chargestation.authorization.requested / accepted / rejecteddata is an Action

Occurs when an rfid authorization request is received and processed.

Synchronous Events

Events that are triggered by Developer or User actions via the API or Dashboard.

organization.updated data is an Organization
Occurs whenever an organization's data is updated.

location.created data is a Location
Occurs whenever a new location is created.

location.updated data is a Location
Occurs whenever a location is updated. E.g. when business hours are changed.

location.deleted data is a Location
Occurs whenever a location is deleted.

chargestation.created data is a Chargestation
Occurs whenever a new chargestation is created.

chargestation.updated data is a Chargestation
The following fields trigger a chargestation update:

chargestation.endpoint : An update to the Websocket connection URL
chargestation.active : A change usually via an API call or the dashboard
chargestation.public : A change usually via an API call or the dashboard
chargestation.open_for_business : A change usually via an API call or the dashboard
chargestation.meta_data : Any changes to the meta_data field

chargestation.deleted data is a Chargestation
Occurs whenever a chargestation is deleted.

chargestation.connector.created data is a Chargestation
Occurs whenever a connector is created.

chargestation.connector.updated data is a Chargestation
All field changes will trigger an update event. E.g. when a connector is plugged in.

chargestation.connector.deleted data is a Chargestation
Occurs whenever a connector is deleted.

user.created data is a User
Occurs whenever a new user is created.

user.updated data is a User
All field changes will trigger a user update.

user.deleted data is a User
Whenever a user is deleted.

rate.created data is a Rate
Occurs whenever a new rate is created.

rate.updated data is a Rate
All field changes will trigger an update.

rate.deleted data is a Rate
Whenever a rate is deleted.

rate_schedule.created data is a Advance Rate
Occurs whenever a new rate schedule is created.

rate_schedule.updated data is a Advance Rate
All field changes will trigger an update.

rate_schedule.deleted data is a Advance Rate
Whenever a rate schedule is deleted.

rfid.created data is a RFID
Occurs whenever a new rfid is created.

rfid.updated data is a RFID
All field changes will trigger an update.

rfid.deleted data is a RFID
Whenever a rfid is deleted.

session.created data is a Session
Occurs whenever a new session has been created. eDRV is yet to receive a charging start event from the chargestation.

load_management.group.created data is a Load Management

Occurs when a load management group is created.

load_management.group.updated data is a Load Management

Occurs when a load management group is updated.

load_management.group.deleted data is a Load Management

Occurs when a load management group is updated.

load_management.group.chargestation.added data is a Load Management

Occurs when charge station is added to the load management group

load_management.group.chargestation.removed data is a Load Management

Occurs when charge station is removed from the load management group

Charging Intelligence Events

Events that are triggered by eDRV charging intelligence. See Charging Intelligence

session.ev_charged data is a Session
Occurs when eDRV detects that an EV is fully charged.

session.target.cost.reached data is a Session
Occurs when eDRV detects that a session reached the target cost value.

session.target.time.reached data is a Session
Occurs when eDRV detects that a session reached the target time value.

session.target.power.reached data is a Session
Occurs when eDRV detects that a session reached the target energy value.

session.target.soc.reached data is a Session
Occurs when eDRV detects that a session reached the target state of charge value.