License events fire in response to changes in the DDLS license lifecycle.
Events #
license.created #
Fired when: A new license is generated in DDLS.
DDLS Hook: dmsi_license_created
Typical payload data fields:
| Field | Type | Description |
|---|---|---|
license_key | string | The license key value |
product_id | integer | Associated product ID |
product_name | string | Product name |
customer | object | Customer info: {id, email, name} |
status | string | Initial license status |
expires_at | string | Expiry date (ISO 8601) or null for lifetime |
created_at | string | Date license was created (ISO 8601) |
—
license.activated #
Fired when: A license key is successfully activated on a site or device.
DDLS Hook: dmsi_license_activated
Typical payload data fields:
| Field | Type | Description |
|---|---|---|
license_key | string | The license key |
site_url | string | URL or identifier of the site being activated |
activations | integer | Total current activations |
max_activations | integer | Maximum activations allowed |
activated_at | string | Activation timestamp (ISO 8601) |
—
license.expired #
Fired when: A license reaches its expiry date.
DDLS Hook: dmsi_license_expired
Typical payload data fields:
| Field | Type | Description |
|---|---|---|
license_key | string | The license key |
product_id | integer | Associated product ID |
customer | object | Customer info: {id, email} |
expired_at | string | The expiry date that was reached (ISO 8601) |
—
license.renewed #
Fired when: A license renewal is processed and the expiry date is extended.
DDLS Hook: dmsi_license_renewed
Typical payload data fields:
| Field | Type | Description |
|---|---|---|
license_key | string | The license key |
product_id | integer | Associated product ID |
new_expiry | string | New expiry date (ISO 8601) |
previous_expiry | string | Previous expiry date (ISO 8601) |
renewed_at | string | Renewal timestamp (ISO 8601) |
—
Use Cases #
- Provision access in an external system when
license.createdfires - Invalidate cached license status when
license.expiredfires - Notify a CRM when
license.renewedfires - Track activations for analytics when
license.activatedfires
Related Topics #
- Event Types Overview
- Subscription Events
- Payment Events
- Payload Reference