#
Cloud Service

Soracom Event Handler

Automated rules for IoT fleet operations

Automate SIM and device workflows the moment usage or status changes

Catch high-cost usage, device inactivity or suspicious behavior early

Automate operational tasks and enforce policies across your SIM fleet. Instead of manually monitoring usage or reacting to unexpected device behavior, Event Handler evaluates real-time metrics and executes predefined actions automatically. This helps control cost, reduce risk, and maintain reliable operation at scale without manual intervention or custom backend tooling.

  • Usage-based automation: Trigger actions when devices exceed data thresholds, session counts, or billing limits.
  • Behavior monitoring: Detect IMEI changes, unusual data spikes, or abnormal roaming patterns.
  • Instant actions: Auto-suspend SIMs, change speed class, send alerts, or call webhooks.

Why use Soracom Event Handler?

Trigger immediately and automatically

Replace manual checking and spreadsheets with rules that monitor and act in real-time.

Respond to fleet events automatically

Whether data over-usage, speed class changes or status shifts, you can automate your remediation workflows.

Improve cost control and reliability

Prevent runaway data usage, idle SIMs or misconfigured devices by proactively triggering actions.

How it works

Extensive rule library for SIM, subscriber and operator events

Choose from dozens of built-in rules such as data usage (daily/monthly/cumulative), SIM status changes, speed class changes or first traffic events, and apply rules at multiple targets (SIM, group, operator).

Automated actions including emails, webhooks, SIM state control and AWS integration

Once a rule triggers, you can execute up to five actions per handler: send email, call webhook, change SIM status (Active/Standby/Suspended), change speed class, or invoke AWS Lambda—enabling powerful automated responses.

Apply handlers at scale across fleets or individually

Configure handlers that apply to a single SIM, an entire subscriber, a group of SIMs, or your whole operator account—giving flexibility whether you’re managing a few devices or tens of thousands.

Take a shortcut directly to technical documentation

Explore full rule sets, action types, API/CLI integration, and sample configurations to start automating your IoT operations.

Key takeways for using Soracom Event Handler

Lock Icon with Keyhole

Scale operationally

Automate fleet-wide responses instead of manual intervention.

Soracom Event Handler icon

Reduce surprises

Get ahead of billing, usage or device issues by reacting immediately.

Checkmark icon

Lower overhead

Remove custom pipelines and operations scripts by embedding logic into the network.

What you’d build without Event Handler

Manual monitoring and alerts process for data usage or SIM state
You’d need custom scripts, cron jobs or BI dashboards to detect when a SIM exceeds a data threshold or goes inactive.

Separate command infrastructure for handling device states
You’d build workflows that call the Soracom API manually or via internal tools, adding maintenance overhead.

Delay in responding to downstream effects
Your team would react to billing surprises, inactive fleets or data over-usage only after it’s reported—not proactively when it happens.

How it is implemented

Event Handler operates within the Soracom connectivity core. Rules evaluate incoming data usage, SIM status, subscriber sessions or other defined metrics. When a rule condition is met, the configured actions execute via Soracom API, webhook, email or third-party services. Targets can be individual SIMs, groups, subscribers or operator-wide. Vehicles include variables for dynamic context such as ${simId}, ${imsi}, ${currentTotalAmount}.

Step 1

Enable Soracom Event Handler for your SIM group and choose your trigger conditions

Open the Soracom User Console and navigate to the SIM group where you want to automate actions.
Enable Soracom Event Handler in the group settings, then select the event types you want to monitor—such as SIM status changes, usage thresholds, location updates, session events, or device behavior anomalies.

Event Handler watches these conditions in real time and can trigger automated workflows without needing custom backend code or cloud functions.
Setup details can be found in the Event Handler documentation.

Step 2

Define automated actions to run when your selected events occur

Use the Event Handler rule editor to define the actions that should run when an event is detected—such as sending alerts, suspending a SIM, tagging a device, calling a webhook, or executing a Soracom API request.
Actions can also trigger integrations with other Soracom services like Harvest, Funnel, Funk, or Flux to create more advanced workflows.

This lets you automate operational responses, enforce data policies, or detect and handle abnormal device behavior without human intervention.
See action options in the Event Handler actions guide.

Step 3

Test, activate, and monitor your automation rules

Once your rules are created, test them using simulated events or by generating a real event from your device or SIM group.
After activating the rule, Event Handler automatically executes your actions whenever conditions are met, with no servers or cron jobs to maintain.

Use the Event Handler dashboard to review rule history, verify successful executions, and troubleshoot unexpected behavior.
Monitoring and debugging details are available in the Event Handler monitoring guide.

What you’d build without Event Handler

Manual monitoring and alerts for data usage or SIM state
You’d need custom scripts, cron jobs or BI dashboards to detect when a SIM exceeds a data threshold or goes inactive.

Separate command infrastructure for handling device states
You’d build workflows that call the Soracom API manually or via internal tools, adding maintenance overhead.

Delay in responding to downstream effects
Your team would react to billing surprises, inactive fleets or data over-usage only after it’s reported—not proactively when it happens.

#

Automate your IoT workflows with Soracom Event Handler

Create a free Soracom Operator ID and start configuring rules to monitor, notify and act on SIM events, usage spikes and lifecycle transitions.

Get started

Frequently Asked Questions

What is Soracom Event Handler?
It is a service that triggers automated actions based on defined rules applied to SIMs, subscribers, groups or operators.
What actions can Event Handler perform?
Send email, send email to operator, execute web requests (webhooks), invoke AWS Lambda, change SIM status (Active, Inactive, Standby, Suspend), change speed class.
Do rules execute immediately when a condition is met?
Not always. For certain rules (usage thresholds) there may be a delay (up to 5 minutes for data usage, or up to 24 hours for monthly billing) before actions trigger.
What types of rules are supported?
Data usage thresholds (daily, monthly, cumulative), SIM or subscriber status changes, speed class changes, first traffic, and others.
How many event handlers can I configure?
Each target (SIM, subscriber, group, operator) can have up to 10 handlers.