# Events API

<Aside type="note">
要跟踪用户触发的事件，请调用 User Centric API 中的 [/postEvent](/zh/developer/api-reference/user-centric-api#postevent) 方法。
</Aside>

## createEvent

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

为应用程序创建一个 Event（事件）。

#### Request Body

| 名称 | 类型 | 描述 |
| --- | --- | --- |
| auth\* | string | 来自 Pushwoosh 控制面板的 [API Access Token](/zh/developer/api-reference/api-identifiers/#api-access-token)。 |
| application\* | string | [Pushwoosh Application Code](/zh/developer/api-reference/api-identifiers/#application-code) |
| name | string | Event 名称，最多 32 个字符。 |
| description | string | Event 描述，最多 64 个字符。 |
| eventAttributes | array | Event 属性数组。 |
| trackRevenue | boolean | 请参阅 Track Event Revenue 部分。 |

<Tabs>
<TabItem label="200">
```javascript
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "event": 351 // 已创建的 Event Id
  }
}
```
</TabItem>
</Tabs>

```javascript
{
  "request": {
    "auth":"yxoPUlwqm…………pIyEX4H",     // 必填。来自 Pushwoosh 控制面板的 API Access Token
    "application": "XXXXX-XXXXX",      // 必填。Pushwoosh Application Code
    "name": "BasketOpen",              // 必填。最多 32 个字符。Event 名称。
    "description": "Open basket page", // 可选。最多 64 个字符。Event 描述。
    "eventAttributes": [{              // 可选。Event 属性数组
      "type": 3,                       // 属性类型。值：
                                       // 1 - 整数;
                                       // 2 - 字符串;
                                       // 3 - 列表;
                                       // 4 - 日期;
                                       // 5 - 布尔值;
                                       // 6 - 价格;
      "name": "products"               // 最多 64 个字符。属性名称
    }, {
      "type": 5,
      "name": "delivery"
    }],
    "trackRevenue": false
  }
}
```

**Response:**

| | | |
| --- | --- | --- |
| 200 | 200 | Event 创建成功 |
| 200 | 210 | 参数错误。查看 status\_message 获取更多信息 |
| 200 | 403 | 权限错误（例如，当超出 Events 限制时） |
| 200 | 404 | 资源未找到 |
| 400 | N/A | 请求字符串格式错误 |
| 500 | 500 | 内部错误 |