---
title: "Using the Event Builder"
slug: "using-the-event-builder"
abstract: "Explains how to use the Event Builder in the Customer Engagement Console (CEC)."
---
# Using the Event Builder

The Event Builder uses a GUI to teach developers how to properly build different events and push them to Discover. It also provides live responses, giving real-time feedback on event object formatting.

The Event Builder is separated into three panes, each representing one of the following three tools:

- [Builder](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/using-the-event-builder.html#UUID-361efc3a-3443-29a8-bf6c-7d6647d370b3_section-idm4598087983812833092575630835 "Builder")
- [Request](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/using-the-event-builder.html#UUID-361efc3a-3443-29a8-bf6c-7d6647d370b3_section-idm4631416909787233092575865015 "Request")
- [Response](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/using-the-event-builder.html#UUID-361efc3a-3443-29a8-bf6c-7d6647d370b3_section-idm4491380159081633092576103243 "Response")

<details>
<summary><h2>Builder</h2></summary>

The **Builder** panel is located in the left-hand side of the Event Builder. You can use it to construct events using different options.

You must make choices for the following options:

- **API** - The **API** section of the **Builder** panel contains two options: **rfk.push()** and **REST API**. You can create events for use with runtime JavaScript by choosing the **rfk.push()** option or you can create events for use with REST APIs by choosing the **REST API** option.
- **EVENT** - The **EVENT** section of the **Builder** panel contains two options: **Widget** and **Non-Widget**. You can create widget interaction events such as `click` and `appear` by choosing the **Widget** option. You can create funnel, cart status, and user login events by choosing the **Non-Widget** option.

    > [!tip]
    > More information about types of events can be found in [Event Specifications](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/event-specifications.html "Event specifications").

Subsequent choices and required input depend upon your choices for these two options. For example, if you choose to [create a widget event](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/using-the-event-builder/build-a-widget-click-event-using-the-event-builder.html "Build a widget click event using the Event Builder"), you are prompted to supply values for **PAGE** and **WIDGET**. On the other hand, if you choose to [create a non-widget event](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/using-the-event-builder/build-an-add-to-cart-event-using-the-event-builder.html "Build an add to cart event using the Event Builder"), you are prompted to **CHOOSE EVENT TO TRACK** and to supply the **EVENT NAME**.

> [!tip]
> When you create an event object for the REST API, the following values are auto-completed: `t`, `t0`, and `uuid`.

When you have filled out all of the required information, click **Build**. Your event is displayed in the [Request](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/using-the-event-builder.html#UUID-361efc3a-3443-29a8-bf6c-7d6647d370b3_section-idm4631416909787233092575865015 "Request") panel in JSON format.

</details>

<details>
<summary><h2>Request</h2></summary>

The **Request** panel, located in the center of the Event Builder page, displays the event created in **Builder** in JSON format, along with any messages about missing or auto-completed values.

You can copy the request as cURL or a data object by clicking **Copy to Clipboard as...**

You can click **Validate** to test your request object.

Alternatively, you can extract an event from the [Event Monitor](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/the-customer-engagement-console/using-the-event-monitor.md "Using the Event Monitor") that is causing an error and paste it into the **Request** panel, then click **Validate**. This can help you debug and understand how to fix the error.

</details>

<details>
<summary><h2>Response</h2></summary>

The JSON response to your request, along with the status code and any errors are displayed in this panel, located on the right-hand side of the page.

To export the response, click **Copy to Clipboard as...**, then **Copy as data object**.

</details>