ServicesPlatformEventsEvent types

Custom events

IDDescription
72Custom
API reference

The configured parameters of a custom event are in the event’s detail object.

Custom

A custom event configured in your Workspace was triggered.

Unlike system events, custom events are based on templates that you configure with your own parameters, such as a data traffic threshold or a severity level. All custom events share the same event type Custom (ID 72), no matter which template they’re based on. To identify which custom event was triggered, use the template_id property of the detail object.

Because custom events are evaluated by the emnify event processing engine, their event source is Semantic (ID 3). The event severity is the severity you set when adding the rule.

The detail object of a custom event contains the following properties:

PropertyTypeDescription
template_idStringIdentifier of the custom event template the event is based on (for example, daily-traffic-threshold-v1).
_metaJSON objectMetadata about the custom event that generated this event.
_meta.nameStringName of the custom event template (for example, Daily traffic threshold).
_meta.codeStringUnique identifier of the custom event configured in your Workspace.
_meta.idStringUnique identifier of this occurrence of the custom event.
_meta.versionLongVersion of the custom event configuration.

The remaining properties depend on the template. For example, the Daily traffic threshold template adds the configured threshold (threshold_volume) and the volume that was actually consumed (total_volume), both in megabytes (MB).

Custom events are also listed in the emnify Portal alongside system events. See Custom events in the events log.

1{
2  "timestamp": "2026-07-01T11:26:47.638Z",
3  "alert": true,
4  "description": "Daily endpoint volume threshold of 1 reached for endpoint: Test Sim 2",
5  "id": 2555084928745473,
6  "event_type": {
7    "id": 72,
8    "description": "Custom"
9  },
10  "event_source": {
11    "id": 3,
12    "description": "Semantic"
13  },
14  "event_severity": {
15    "id": 0,
16    "description": "INFO"
17  },
18  "organisation": {
19    "id": 1572,
20    "name": "Test Org"
21  },
22  "user": null,
23  "endpoint": {
24    "id": 18018628,
25    "name": "Test Sim 2",
26    "ip_address": "10.192.200.49",
27    "tags": "monitoring",
28    "imei": "3530570910841456"
29  },
30  "sim": null,
31  "imsi": null,
32  "detail": {
33    "_meta": {
34      "code": "019d0bec-2688-776f-b30e-c282580b1720",
35      "id": "019d0bec-2688-776f-b30e-c282580b1720_1774021520051",
36      "version": 1775649028911,
37      "name": "Daily traffic threshold"
38    },
39    "threshold_volume": "1",
40    "total_volume": "24.586832",
41    "template_id": "daily-traffic-threshold-v1"
42  }
43}