Delete SMS

The Delete SMS action removes one or more messages from your NETGEAR LTE modem inbox, using their inbox IDs.

This is handy when you want to keep the modem inbox tidy, for example by deleting an incoming message after an automation has processed it.

Using this action from the user interface

If you prefer building automations and scripts visually, Home Assistant walks you through this action step by step. You pick what to target, tweak a few options, and save. No YAML knowledge required.

To delete messages from an automation or a script:

  1. Go to Settings > Automations & scenes.
  2. Open an existing automation or script, or select Create automation > Create new automation.
  3. If you’re setting up a new automation, add a trigger in the When section. Scripts don’t need a trigger. They run when something else calls them.
  4. In the Then do section, select Add action.
  5. From the search box, search for and select NETGEAR LTE: Delete SMS.
  6. Enter the SMS ID of the message, or a list of message IDs, to delete. If you have more than one modem, also enter the Host.
  7. Select Save.

This action does not support targets. In the UI, you select the modem through the Host field instead of choosing an area, device, entity, or label. When you have only one modem configured, you can leave it empty.

Options in the UI

Host (Optional)

The modem to delete messages from. Optional when only one modem is configured.

SMS ID (Required)

A single inbox ID, or a list of inbox IDs, of the messages to delete.

Using this action in YAML

If you work directly in YAML, or you want to know exactly what Home Assistant does under the hood, this section has the technical reference. It lists the field names you use in YAML, their types, and which ones are required.

In YAML, refer to this action as netgear_lte.delete_sms. A basic example looks like this:

ActionActions are used in several places in Home Assistant. As part of a script or automation, actions define what is going to happen once a trigger is activated. In scripts, an action is called *sequence*. [Learn more]
action: netgear_lte.delete_sms
data:
  host: 192.168.5.1
  sms_id:
    - 7
    - 8

This deletes the messages with inbox IDs 7 and 8 from the modem.

Options in YAML

host string

The modem to delete messages from. Optional when only one modem is configured.

sms_id integer Required

A single inbox ID, or a list of inbox IDs, of the messages to delete.

Try it yourself

Ready to test this? Open Developer tools > Actions, search for this action, fill in the fields, and select Perform action. You see what happens on your actual entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] without writing a line of YAML.

More examples

Real scenarios where this action shows up in automations and scripts. Copy any example and adapt it to your setup.

Tip

You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.

Automation: delete an SMS after processing it

When a new SMS arrives, process it and then remove it from the modem inbox.

  • Trigger: A netgear_lte_sms event fires
  • Action: NETGEAR LTE: Delete SMS
YAML example for deleting an SMS after processing
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
alias: "Clean up processed SMS"
triggers:
  - trigger: event
    event_type: netgear_lte_sms
actions:
  - action: netgear_lte.delete_sms
    data:
      host: "{{ trigger.event.data.host }}"
      sms_id: "{{ trigger.event.data.sms_id }}"

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with the action you’re calling and what you expected to happen, or share on our subreddit /r/homeassistant.

Tip

AI assistants like ChatGPT or Claude can also explain actions or suggest the right one when you describe what you want in plain language.

Related actions

These actions work well alongside this one:

  • Connect LTE: Asks the NETGEAR LTE modem to establish its LTE connection.

  • Disconnect LTE: Asks the NETGEAR LTE modem to close its LTE connection.

  • Set option: Sets connection options on the NETGEAR LTE modem.