# Custom events

**PushExpress -- Custom events**

* [Creating custom events](#creating-custom-events)
* [Sending an event to the PushExpress](#sending-an-event-to-the-PushExpress)
* [Events in the task settings](#events-in-the-task-settings)
* [Event analytics](#event-analytics)
* [Second, third and subsequent deposits](#second-third-and-subsequent-deposits)

### Creating custom events

[Create an event using the API.](https://docs.push.express/api/custom-events#create-an-custom-events)

### Sending an event to the PushExpress

[Go to the Segments section.](https://app.push.express/postbacks/offers/)

> Get an overview of all your events and segments.

<div align="center"><img src="/files/CSG7xqdAEgdE5nDvxhCX" alt="" width="800"></div>

<sup>*Segments page*</sup>

> The "URL for sending postback" column will contain the url for the GET request to add an event to the device. Replace {your installation id} with the ID of the device where the event occurred.

<div align="center"><img src="/files/CPpdEubTb8mwynhhj21T" alt="" width="800"></div>

<sup>*URL for sending postback*</sup>

### Events in the task settings

After creating the event, it will become available in the settings of all types of tasks. The Registration and Deposit system events cannot be changed. Custom events will be displayed in the task filters "What event have occurred" and "What event have NOT occurred" after system events.

<div align="center"><img src="/files/ySlO6qtAqHZsMO3DOZHn" alt="" width="800"></div>

<div align="center"><img src="/files/P7uJ9k0EXVn9QE0mAKfF" alt="" width="800"></div>

<sup>*Adding an event to a task*</sup>

### Event analytics

You can see the total number of devices on which the event occurred in the [Segments section](https://app.push.express/postbacks/offers/) -> Custom events

<div align="center"><img src="/files/tn6xM0K0UKGpjCKKkRsF" alt="" width="800"></div>

### Second, third and subsequent deposits

The service automatically tracks each deposit made on a device. For every new deposit, the system records an event with its sequential number (first, second, third, etc.) The total count of devices containing these events is available in the [Segments section](https://app.push.express/postbacks/offers/) -> System events

<div align="center"><img src="/files/OuWJFa6x6ZKmn8q8UChj" alt="" width="800"></div>

You may define task conditions by utilizing these events.

<div align="center"><img src="/files/sjkO4i9sS6geZxyDNIqU" alt="" width="800"></div>


---

# 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://docs.push.express/quckstart/custom_events.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.