# Reporting your first event

## Overview

In this tutorial, you’ll report your first **private event** to the White Label Loyalty (WLL) API. You’ll practice authenticating with your event type secret and sending an event payload in **staging (Test) mode**.

By the end, you’ll be able to:

* Report a private event to the `/events` endpoint.
* Verify that the API accepted your event.

***

## Prerequisites

Before starting, make sure you have:

* Access to the Loyalty Console with your tenant and your **tenant API key**.
* A [user account created](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/users/creating-users) in the **Test mode** of your console (the event reported in this tutorial will be linked to this user).
* A tool to make API requests (e.g. <kbd>curl</kbd>, Postman, or your preferred programming language).

***

## Instructions

{% stepper %}
{% step %}

### Create a private event type

Follow the instructions in [Creating event types](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/event-types/creating-event-types) to create a private event type called <kbd>VISITED\_VENUE</kbd> using the Loyalty Console.

Once the event type is created, keep the event secret handy for the next steps.

<div data-with-frame="true"><figure><img src="/files/qowCDrJAvIfVO4BOslqU" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Set your base URL

All calls in this tutorial will use the **staging (Test) environment**:

```
https://api.staging.rewards.wlloyalty.net/v1
```

{% endstep %}

{% step %}

### Prepare your authorization header

You’ll use the event type **secret** to authenticate.

```
Authorization: Bearer <event_type_secret>
```

{% endstep %}

{% step %}

### Prepare the user ID

You need the user ID of the account you're reporting the event for.

1. In the Loyalty Console, go to **Users → Members**.
2. Select the intended user.
3. Copy the UUID visible under **ID** (e.g. `0e647aed-d12d-4b1c-9521-4ee122424e12`).
   {% endstep %}

{% step %}

### Send your first event

Here’s a minimal example using <kbd>curl</kbd>:

{% code expandable="true" %}

```bash
curl -X POST "https://api.staging.rewards.wlloyalty.net/v1/events" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <event_type_secret>" \
  -H "x-api-key: <your_tenant_api_key>" \
  -d '{
    "type": "VISITED_VENUE",
    "subject": "<user_id>",
    "payload": {
      "amountSpent": 100,
      "currency": "USD",
      "minutesSpent": 120,
    }
  }'
```

{% endcode %}

Here's an example in Node.js using <kbd>axios</kbd>:

{% code expandable="true" %}

```javascript
import axios from "axios";

const EVENT_TYPE_SECRET = "<event_type_secret>";
const EVENT_TYPE_NAME = "VISITED_VENUE";
const API_KEY = "<your_tenant_api_key>"

async function reportEvent() {
  const response = await axios.post(
    "https://api.staging.rewards.wlloyalty.net/v1/events",
    {
      type: EVENT_TYPE_NAME,
      subject: "<user_id>",
      properties: {
        amountSpent: 100,
        currency: "USD",
        minutesSpent: 120
      },
    },
    {
      headers: {
        Authorization: `Bearer ${EVENT_TYPE_SECRET}`,
        "Content-Type": "application/json",
        "x-api-key": API_KEY
      },
    }
  );

  console.log("Event reported:", response.data);
}

await reportEvent();
```

{% endcode %}
{% endstep %}

{% step %}

### Verify the response

* A successful response returns **200 OK** with the reported event payload.
* In the Loyalty Console, check the **Activity** section to confirm the event appears for the intended user.
  {% endstep %}
  {% endstepper %}

### Recap

* You authenticated using an **event type secret**.
* You reported a **private event** to the WLL API.
* You confirmed the event was accepted in staging mode for the intended user.

***

## Assessment

Try the following:

1. Change the `subject` from user `ID` to `accountNumber` or `authIdentifier` and send another event.
2. Add a custom property (e.g., `"venueId": "12345"`) to the event payload.
3. What response do you get if you use an invalid secret?

***

## Next steps

* See [Reporting events](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/reporting-events) for deeper explanation
* See the [API reference for reporting events](https://docs.whitelabel-loyalty.com/rewards.html#events-events-collection-post) for all available fields
* Continue to the next tutorial, [Checking audience membership](/developer/tutorials/checking-audience-membership.md)

***


---

# 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://kbase.whitelabel-loyalty.com/developer/tutorials/reporting-your-first-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.