# Push Notification Received

This event is triggered when the application is active and a new push notification message is received.

{% hint style="info" %}
This event is triggered in the current form, and if it does not exist in the current form is triggered in the first form. So if this event is only defined in the application first form, any push notification message received will be handled by this event on the first form.
{% endhint %}

{% hint style="info" %}
In order for push notifications to become available you need to select the option Enable Push Notifications in the project properties.
{% endhint %}

{% hint style="info" %}
If the application is not active the push notification will be handled by the O.S. and if you enabled the "*Save messages when application is not active*" option in your project properties, it will be saved locally on the device. You can use "Push Notification ... Lost ..." actions to retrieve the messages that where received while your application was not active.
{% endhint %}

{% hint style="info" %}
Lost Messages are also saved if this event is not executed for a specific message. (Application is closed or application is open but the event is not handled neither by the current nor the first form)
{% endhint %}

#### Event available on the following operating systems

![](/files/kfMeq0OanEe5OOx5RmUn)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.sysdevmobile.com/kalipso5/developing/form/controls/events/push-notification-received.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.