# API событий

API событий создает событие в приложении Pushwoosh вместе с его описанием и атрибутами. Создавать событие заранее необязательно. Используйте этот API, если хотите задать типы атрибутов самостоятельно: `/postEvent` автоматически создает отсутствующее событие и определяет типы атрибутов по полученным значениям.

<Aside type="note">
Чтобы отслеживать события, инициированные пользователями, вызовите метод [/postEvent](/ru/developer/api-reference/user-centric-api#postevent) из User Centric API.
</Aside>

## createEvent

`POST` `https://api.pushwoosh.com/json/1.3/createEvent`

Создает событие для приложения.

#### Тело запроса

| Имя                                           | Тип     | Описание                                                                   |
| --------------------------------------------- | ------- | -------------------------------------------------------------------------- |
| auth\*        | string  | [Токен доступа API](/ru/developer/api-reference/api-identifiers/#api-access-token) из Панели управления Pushwoosh.                             |
| application\* | string  | [Код приложения Pushwoosh](/ru/developer/api-reference/api-identifiers/#application-code)                                                |
| name                                          | string  | Название события, макс. 128 символов.                                            |
| description                                   | string  | Описание события, макс. 512 символов.                                     |
| eventAttributes                               | array   | Массив атрибутов события.                                                    |
| trackRevenue                                  | boolean | См. раздел Track Event Revenue.  |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "event": 351 // ID созданного события
  }
}
```
</TabItem>
</Tabs>

```json
{
  "request": {
    "auth":"yxoPUlwqm…………pIyEX4H",     // обязательно. Токен доступа API из Панели управления Pushwoosh
    "application": "XXXXX-XXXXX",      // обязательно. Код приложения Pushwoosh
    "name": "BasketOpen",              // обязательно. Название события, макс. 128 символов. 
    "description": "Open basket page", // необязательно. Описание события, макс. 512 символов. 
    "eventAttributes": [{              // необязательно. Массив атрибутов события
      "type": 3,                       // Тип атрибута. Значения:
                                       // 1 - integer (целое число);
                                       // 2 - string (строка);
                                       // 3 - list (список);
                                       // 4 - date (дата);
                                       // 5 - boolean (логический);
                                       // 6 - price (цена);
      "name": "products"               // Имя атрибута, макс. 255 символов. 
    }, {
      "type": 5,
      "name": "delivery"
    }],
    "trackRevenue": false
  }
}
```

**Ответ:**

|     |     |                                                                |
| --- | --- | -------------------------------------------------------------- |
| 200 | 200 | Событие успешно создано                                     |
| 200 | 210 | Ошибка аргумента. См. status\_message для получения дополнительной информации              |
| 200 | 403 | Ошибка прав доступа (например, при превышении лимита событий) |
| 200 | 404 | Ресурс не найден                                             |
| 400 | N/A | Неверно сформированная строка запроса                                       |
| 500 | 500 | Внутренняя ошибка                                                 |