# Create Customer Event

## Create Customer Event

<mark style="color:green;">`POST`</mark> `https://beacon.crowdpower.io/events`

#### Request Body

| Name                                       | Type    | Description                                                                            |
| ------------------------------------------ | ------- | -------------------------------------------------------------------------------------- |
| user\_id<mark style="color:red;">\*</mark> | string  | The unique ID for the user.                                                            |
| action<mark style="color:red;">\*</mark>   | string  | The action the user performed.                                                         |
| properties                                 | object  | Information about the event, sent as key/value pairs. Use snake\_case for key names.   |
| created\_at                                | integer | When the event happened. Automatically set if not provided. UNIX timestamp in seconds. |
| email                                      | string  | The user’s email address. Required if user\_id is not present.                         |
| update\_session                            | boolean | Whether or not to update the user’s session. Defaults to true.                         |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "success": true,
  "code": 200,
  "data": null
}
```

{% endtab %}
{% endtabs %}

## Create Multiple Customer Events

<mark style="color:green;">`POST`</mark> `https://beacon.crowdpower.io/events/bulk`

#### Request Body

| Name                                       | Type   | Description                                                    |
| ------------------------------------------ | ------ | -------------------------------------------------------------- |
| user\_id<mark style="color:red;">\*</mark> | string | The unique ID for the user.                                    |
| events<mark style="color:red;">\*</mark>   | array  | An array of event objects.                                     |
| email                                      | string | The user’s email address. Required if user\_id is not present. |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "success": true,
  "code": 200,
  "data": null
}
```

{% endtab %}
{% endtabs %}