# 创建埋点事件

> 创建打点事件，注意目前仅支持创建，不支持修改，如需修改，请到 GrowingIO 平台管理界面修改。
>
> 打点事件支持批量创建，如果一次仅创建一条，body 内也需要使用数组形式。

### URL

<https://www.growingio.com/v1/api/projects/{project\\_uid}/dim/events>

### 请求类型

POST

### 请求头参数

公共头部请参考[公共请求头参数](/docs/developer-manual/api-reference/authenticate.md)。

### 请求参数与示例

{% tabs %}
{% tab title="请求参数" %}

| 路径参数         | 类型     | 是否必传 | 说明     |
| ------------ | ------ | ---- | ------ |
| project\_uid | string | 是    | 项目UID。 |

| body参数      | 类型     | 是否必传 | 说明                                          |
| ----------- | ------ | ---- | ------------------------------------------- |
| name        | string | 是    | 事件名称，最大长度为30字符                              |
| type        | string | 是    | <p>事件类型。</p><ul><li>counter：计数器</li></ul>   |
| key         | string | 是    | 事件标识符，只允许以字母或下划线开头，包含下划线、字母和数字的字符串，最大长度是50. |
| description | string | 否    | 事件描述。                                       |
| attrs       | array  | 否    | 事件关联的维度属性。                                  |

attrs字段为事件需要关联的维度属性，以下为attrs对应的字段：

| 名称           | 类型    | 是否必传 | 说明         |
| ------------ | ----- | ---- | ---------- |
| id           | Sring | 是    | 事件级变量的UID。 |
| {% endtab %} |       |      |            |

{% tab title="响应示例" %}
200：OK
{% endtab %}
{% endtabs %}


---

# 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://growingio.gitbook.io/docs/developer-manual/api-reference/project-manage/create-event.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.