---
agentTools:
  projectIndex: https://docs.edrv.io/llms.txt
---

# 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](https://docs.edrv.io/docs/chargestation)\
Whenever a charge station connects to eDRV. This event is FIFO ordered per chargestation.

**chargestation.offline** `data` is a [Chargestation](https://docs.edrv.io/docs/chargestation)\
Whenever a charge station loses connection to eDRV. This event is FIFO ordered per chargestation.

**chargestation.connector\_status.updated** `data` is a [Chargestation](https://docs.edrv.io/docs/chargestation) with [Connector](https://docs.edrv.io/docs/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](https://docs.edrv.io/docs/sessions)\
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](https://docs.edrv.io/docs/sessions)\
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](https://docs.edrv.io/docs/sessions)\
Occurs whenever the chargestation confirms that an energy transaction has stopped.This event is FIFO ordered per chargestation.

**session.cancelled** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
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](https://docs.edrv.io/docs/sessions)\
Occurs when the chargestation was unable to start the session.

**session.stop\_failure** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
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 / timeout*** `data` is an [Action](https://docs.edrv.io/docs/actions)\
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](https://docs.edrv.io/docs/actions)\
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 / timeout** \_`data` is an [Action](https://docs.edrv.io/docs/actions)\
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](https://docs.edrv.io/docs/actions)\
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 / timeout*** `data` is an [Action](https://docs.edrv.io/docs/actions)\
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](https://docs.edrv.io/docs/actions)\
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](https://docs.edrv.io/docs/actions)\
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](https://docs.edrv.io/docs/actions)\
Occurs when updating a chargestation configuration via an API call.

***chargestation.trigger\_message.requested / accepted / rejected*** `data` is an  [Action](https://docs.edrv.io/docs/actions)

Occurs when a trigger\_message action is sent via an API call.

***chargestation.get\_local\_list\_version.requested / accepted / rejected***`data` is an  [Action](https://docs.edrv.io/docs/actions)

Occurs when fetching the get\_local\_list\_version via an API call.

***chargestation.send\_local\_list.requested / accepted / rejected***`data` is an  [Action](https://docs.edrv.io/docs/actions)

Occurs when a send\_local\_list action is sent via an API call.

***chargestation.get\_composite\_schedule.requested / accepted / rejected*** `data` is an  [Action](https://docs.edrv.io/docs/actions)

Occurs when fetching get\_composite\_schedule via an API call.

***chargestation.set\_charging\_profile.requested / accepted / rejected / timeout*** `data` is an [Action](https://docs.edrv.io/docs/actions)

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](https://docs.edrv.io/docs/actions)

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 / rejected***`data` is an [Action](https://docs.edrv.io/docs/actions)

Occurs when a GetDiagnostics request is initiated for an OCPP 1.6 chargestation via the API or Admin Panel. Subsequent events indicate whether the request was accepted, rejected, or timed out. These events are FIFO ordered per charge station.

***chargestation.update\_firmware.requested / accepted / rejected***`data` is an [Action](https://docs.edrv.io/docs/actions)

Occurs when an update\_firmware action is sent via an API call or dashboard.

***chargestation.authorization.requested / accepted / rejected***`data` is an [Action](https://docs.edrv.io/docs/actions)

Occurs when an rfid authorization request is received and processed.

***chargestation.get\_log.requested / accepted / rejected/ timeout***`data` is an [Action](https://docs.edrv.io/docs/actions)

Occurs when a GetLog request is initiated for an OCPP 2.0.1 chargestation via the API or Admin Panel. Subsequent events indicate whether the request was accepted, rejected, or timed out. These events are FIFO ordered per charge station.

## Synchronous Events

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

**organization.updated** `data` is an [Organization](https://docs.edrv.io/docs/organization)\
Occurs whenever an organization's data is updated.

**location.created** `data` is a [Location](https://docs.edrv.io/docs/locations)\
Occurs whenever a new location is created.

**location.updated** `data` is a [Location](https://docs.edrv.io/docs/locations)\
Occurs whenever a location is updated. E.g. when business hours are changed.

**location.deleted** `data` is a [Location](https://docs.edrv.io/docs/locations)\
Occurs whenever a location is deleted.

**chargestation.created** `data` is a [Chargestation](https://docs.edrv.io/reference/chargestation)\
Occurs whenever a new chargestation is created.

**chargestation.updated** `data` is a [Chargestation](https://docs.edrv.io/docs/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](https://docs.edrv.io/docs/chargestation)\
Occurs whenever a chargestation is deleted.

**chargestation.connector.created** `data` is a [Chargestation](https://docs.edrv.io/docs/chargestation)\
Occurs whenever a connector is created.

**chargestation.connector.updated** `data` is a [Chargestation](https://docs.edrv.io/docs/chargestation)\
All field changes will trigger an update event. E.g. when a connector is plugged in.

**chargestation.connector.deleted** `data` is a [Chargestation](https://docs.edrv.io/docs/chargestation)\
Occurs whenever a connector is deleted.

**user.created** `data` is a [User](https://docs.edrv.io/reference/driver)\
Occurs whenever a new user is created.

**user.updated** `data` is a [User](https://docs.edrv.io/reference/driver)\
All field changes will trigger a user update.

**user.deleted** `data` is a [User](https://docs.edrv.io/reference/driver)\
Whenever a user is deleted.

**rate.created** `data` is a [Rate](https://docs.edrv.io/reference/prices-rates)\
Occurs whenever a new rate is created.

**rate.updated** `data` is a [Rate](https://docs.edrv.io/reference/prices-rates)\
All field changes will trigger an update.

**rate.deleted** `data` is a [Rate](https://docs.edrv.io/reference/prices-rates)\
Whenever a rate is deleted.

**rate\_schedule.created** `data` is a [Advance Rate](https://docs.edrv.io/reference/prices-rates#advanced-rate-object)\
Occurs whenever a new rate schedule is created.

**rate\_schedule.updated** `data` is a [Advance Rate](https://docs.edrv.io/reference/prices-rates#advanced-rate-object)\
All field changes will trigger an update.

**rate\_schedule.deleted** `data` is a [Advance Rate](https://docs.edrv.io/reference/prices-rates#advanced-rate-object)\
Whenever a rate schedule is deleted.

**rfid.created** `data` is a [RFID](https://docs.edrv.io/reference/rfid)\
Occurs whenever a new rfid is created.

**rfid.updated** `data` is a [RFID](https://docs.edrv.io/reference/rfid)\
All field changes will trigger an update.

**rfid.deleted** `data` is a [RFID](https://docs.edrv.io/reference/rfid)\
Whenever a rfid is deleted.

**session.created** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
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](https://docs.edrv.io/docs/charging-intelligence)

**session.ev\_charged** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
Occurs when eDRV detects that an EV is fully charged.

**session.target.cost.reached** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
Occurs when eDRV detects that a session reached the target cost value.

**session.target.time.reached** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
Occurs when eDRV detects that a session reached the target time value.

**session.target.power.reached** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
Occurs when eDRV detects that a session reached the target energy value.

**session.target.soc.reached** `data` is a [Session](https://docs.edrv.io/docs/sessions)\
Occurs when eDRV detects that a session reached the target state of charge value.