Skip to main content

Notify entity

A notify entity is an entity that can send a message towards a device or service but remains stateless from the Home Assistant perspective.

A notify entity is derived from the homeassistant.components.notify.NotifyEntity, and can be helpful to send notification messages as (but not limited to):

  • an SMS
  • an email
  • a direct message or chat
  • a screen message on a device's LCD display

Unlike a text entity the notify entity has no state that can be set. Instead it represents the date and time of the last message sent.

If you want to represent something that has a text value that can be changed (and thus has an actual state), you should use a text entity instead.


As this integration is stateless, it doesn't provide any specific properties for itself. Other properties that are common to all entities such as icon and name etc are still applicable.


Send message

The send message method is used to send a message to a device or service.

class MyNotifier(NotifyEntity):
# Implement one of these methods.

def send_message(self, message: str, title: str | None = None) -> None:
"""Send a message."""

async def async_send_message(self, message: str, title: str | None = None) -> None:
"""Send a message."""