For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Request featuresContact support
    • Welcome
  • Quickstart
    • Sign up for an account
    • emnify Trial plan
    • Order and auto-register SIMs
    • Register SIMs
    • Create a device
    • Configure the APN
    • emnify REST API
    • Troubleshooting
  • Services
      • Data Streamer
      • Events
        • Event types
        • Work with system events
      • Security
    • Support
LogoLogo
Request featuresContact support
On this page
  • Use cases
  • Structure
  • Event type
  • Event severity
  • Event source
  • User tracking for auditing
  • Working with events
ServicesPlatform

emnify system events

Was this page helpful?

Last updated March 17, 2026

Previous

Available integrations

Next

Event types

Built with

The emnify system generates several types of events. These events allow you to track notable system occurrences based on behavior and provide information about lifecycle transitions and configuration changes.

Event history is stored for 30 days.

Use cases

Some common use cases for events on emnify include:

  • Triggers for custom business processes (for example, authentication or custom usage limitations configured on the emnify Portal)
  • Monitoring (for example, SIM or data connection lifecycles)
  • Input for custom billing systems (for example, updating billing configuration or processing invoices)

Structure

Each event is represented by an object based on the generic Event Object and its associated properties.

Depending on the event type, some generic properties may not apply, and some events may have additional custom fields to provide information about what happened.

Event type

For an overview of the specific events generated by our platform, see Event types.

Event severity

Events are distinguished by three severity levels:

Severity LevelDescription
InfoExpected behavior of the executed event (for example, a device successfully attaches to a network).
WarnProblem or unusual behavior, but doesn’t necessarily require immediate action (for example, a credit card expires in 60 days).
CriticalSerious issue that likely requires additional follow-up (for example, charging for an invoice failed).

Find more information in the API reference.

Event source

Every event is triggered by one of three available event sources:

Event sourceDescription
NetworkThe cellular network your device is connected to (for example, a location is updated or purged).
Policy controlBoth the emnify system and your Workspace can define and enforce policies, quotas, or other limitations
  • The emnify system can block devices that exceed predefined traffic limits.
  • Your Workspace could configure the maximum SMS usage for devices to limit SMS traffic.
APIThe emnify REST API.

Any events triggered in the emnify Portal will show API as the event source, because the Portal is an interface that uses the API under the hood.

Find more information in the API reference.

User tracking for auditing

Device status management events include information about who performed the action. When viewing these events in the Portal, click on an event row to see the Action performed by field, which displays the user’s name, email, and user ID.

User information is available for actions performed through the Portal or API with user credentials. Actions authenticated with application tokens don’t include user details.

Working with events

There are three main ways you can access and trigger events:

  • Data Streamer
  • Event API
  • emnify Portal

More information on these systems and how they compare is available on the Work with events page.