# Events API

<Aside type="note">
لتتبع الأحداث التي يتم تشغيلها بواسطة المستخدمين، اتصل بطريقة [/postEvent](/ar/developer/api-reference/user-centric-api#postevent) من User Centric API.
</Aside>

## createEvent

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

ينشئ حدثًا (Event) للتطبيق.

#### Request Body

| الاسم | النوع | الوصف |
| --- | --- | --- |
| auth* | string | [API access token](/ar/developer/api-reference/api-identifiers/#api-access-token) من لوحة تحكم Pushwoosh. |
| application* | string | [Pushwoosh application code](/ar/developer/api-reference/api-identifiers/#application-code) |
| name | string | اسم الحدث (Event)، بحد أقصى 32 حرفًا. |
| description | string | وصف الحدث (Event)، بحد أقصى 64 حرفًا. |
| eventAttributes | array | مصفوفة سمات الحدث (Event attributes). |
| trackRevenue | boolean | انظر قسم تتبع إيرادات الحدث (Track Event Revenue). |

<Tabs>
<TabItem label="200">
```
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "event": 351 // معرف الحدث (Event Id) الذي تم إنشاؤه
  }
}
```
</TabItem>
</Tabs>

```
{
  "request": {
    "auth":"yxoPUlwqm…………pIyEX4H",     // مطلوب. API access token من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",      // مطلوب. Pushwoosh application code
    "name": "BasketOpen",              // مطلوب. بحد أقصى 32 حرفًا. اسم الحدث.
    "description": "Open basket page", // اختياري. بحد أقصى 64 حرفًا. وصف الحدث.
    "eventAttributes": [{              // اختياري. مصفوفة سمات الحدث
      "type": 3,                       // نوع السمة. القيم:
                                       // 1 - integer;
                                       // 2 - string;
                                       // 3 - list;
                                       // 4 - date;
                                       // 5 - boolean;
                                       // 6 - price;
      "name": "products"               // بحد أقصى 64 حرفًا. اسم السمة
    }, {
      "type": 5,
      "name": "delivery"
    }],
    "trackRevenue": false
  }
}
```

**الاستجابة:**

| | | |
| --- | --- | --- |
| 200 | 200 | تم إنشاء الحدث (Event) بنجاح |
| 200 | 210 | خطأ في المعامل (Argument error). انظر status_message لمزيد من المعلومات |
| 200 | 403 | خطأ في الأذونات (على سبيل المثال، عند تجاوز حد الأحداث) |
| 200 | 404 | المورد غير موجود |
| 400 | N/A | سلسلة طلب مشوهة (Malformed request string) |
| 500 | 500 | خطأ داخلي |