# Events list

### List of events

{% hint style="info" %}
This list will be expanded and new events will be added to it. End goal is to cover Create, Update and Delete events for all objects in LicenseSpring, and add some important action events ( eq. license.activated ).
{% endhint %}

* **customer.deleted**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: customer
* **customer.updated**
  * Publishers: platform, license-api
  * Consumers: webhooks, integrations
  * Data: customer
* **device\_variable.created**
  * Publishers: platform, license-api
  * Consumers: webhooks
  * Data: device\_variable
* **device\_variable.deleted**
  * Publishers: platform
  * Consumers: webhooks
  * Data: device\_variable
* **device\_variable.updated**
  * Publishers: platform, license-api
  * Consumers: webhooks
  * Data: device\_variable
* **installation\_file.created**
  * Publishers: platform
  * Consumers: webhooks
  * Data: installation\_file
* **installation\_file.deleted**
  * Publishers: platform
  * Consumers: webhooks
  * Data: installation\_file
* **installation\_file.updated**
  * Publishers: platform
  * Consumers: webhooks
  * Data: installation\_file
* **license.activated**
  * Publishers: license-api
  * Consumers: webhooks
  * Data: license
* **license.created**
  * Publishers: license-api
  * Consumers: webhooks, integrations
  * Data: license
* **license.deactivated**
  * Publishers: license-api
  * Consumers: webhooks
  * Data: license
* **license.deleted**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: license
* **license.expired**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license
* **license.license\_user.assigned**
  * Publishers: user-portal
  * Consumers: webhooks
  * Data: license, license\_user
* **license.license\_user.unassigned**
  * Publishers: user-portal
  * Consumers: webhooks
  * Data: license, license\_user
* **license.maintenance\_expired**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license
* **license.maintenance\_will\_expire\_3\_days**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license
* **license.reset**
  * Publishers: platform, user-portal
  * Consumers: webhooks
  * Data: license
* **license.updated**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: license
* **license.will\_expire\_3\_days**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license
* **license.will\_expire\_3\_days**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license
* **license\_custom\_field.created**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_custom\_field
* **license\_custom\_field.deleted**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_custom\_field
* **license\_custom\_field.updated**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_custom\_field
* **license\_product\_feature.created**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_product\_feature
* **license\_product\_feature.deleted**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_product\_feature
* **license\_product\_feature.updated**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_product\_feature
* **order.created**
  * Publishers: license-api
  * Consumers: webhooks
  * Data: order
* **order.deleted**
  * Publishers: platform
  * Consumers: webhooks
  * Data: order
* **order.license\_user.manager\_assigned**
  * Publishers: user-portal
  * Consumers: webhooks
  * Data: order, license\_user
* **order.updated**
  * Publishers: platform
  * Consumers: webhooks
  * Data: order
* **product.created**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product
* **product.deleted**
  * Publishers: platform
  * Consumers: webhooks
  * Data: product
* **product.updated**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product
* **product\_custom\_field.created**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product\_custom\_field
* **product\_custom\_field.deleted**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product\_custom\_field
* **product\_custom\_field.updated**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product\_custom\_field
* **product\_feature.created**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product\_feature
* **product\_feature.deleted**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product\_feature
* **product\_feature.updated**
  * Publishers: platform
  * Consumers: webhooks, integrations
  * Data: product\_feature
* **license\_user\_group.created**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_user\_group
* **license\_user\_group.updated**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_user\_group
* **license\_user\_group.deleted**
  * Publishers: platform
  * Consumers: webhooks
  * Data: license\_user\_group
* **license\_user\_group.license\_user.manager\_assigned**
  * Publishers: platform, user-portal
  * Consumers: webhooks
  * Data: license\_user\_group, license\_user

### Global event data

Data sent with each event if applicable.

* id (str) - uuid4 generated unique event id
* event (str) - event code
* company\_id (int) - id of the company for which the event was triggered
* user\_id (int) - id of the user who triggered the event
* ts (int) - unix epoch timestamp of the event occurrence
* data (Object) - custom data depending on event

{% hint style="warning" %}
`user_id` field is optional, and in some cases will be null.
{% endhint %}

### Custom data

This section contains object data definitions for objects that are sent with each event. Which objects are sent with which event is defined in the List of events section above.

* **customer (Object)**
  * id (int)
  * email (str)
  * first\_name (str)
  * last\_name (str)
  * phone (str)
  * reference (str)
  * address (str)
  * postcode (str)
  * city (str)
  * country (str)
  * state (str)
* **license (Object)**
  * id (int)
  * activations\_type (`online` | `offline`)
  * license\_key (str)
  * max\_license\_users (int)
  * is\_trial (boolean)
  * active (boolean)
  * validity\_period (date)
  * enable\_maintenance\_period (boolean)
  * maintenance\_period (date)
  * max\_activations (int)
  * times\_activated (int)
  * enabled (boolean)
  * total\_consumptions (int)
  * max\_consumptions (int)
  * order (Object)
* **license\_user (Object)**
  * id (int)
  * true\_email (str)
  * first\_name (str)
  * last\_name (str)
* **order (Object)**
  * id (int)
  * store\_id (str)
* **product (Object)**
  * id (int)
  * product\_name (str)
  * short\_code (str)
  * active (boolean)
  * authorization\_method (str)
  * is\_archived (boolean)
  * is\_bundle (boolean)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.licensespring.com/events-api/events-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
