---
title: "Send a widget event using the Events REST API"
slug: "send-a-widget-event-using-the-events-rest-api"
abstract: "Describes the procedure for sending a widget event to Sitecore Discover using the Events REST API."
---
# Send a widget event using the Events REST API

There are [many types of events](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/integrate-using-discover-rest-apis/integrate-using-the-events-api/getting-started-with-the-events-api/events-data-model.md "Events data model") you can send using the Events API. If you integrate using the API, you must send all `widget appear` and `widget click` events when a visitor sees or clicks on a widget. This topic shows sample steps for how to send a `widget click` event using the Events REST API.

To send a `widget click`event using the Events REST API:

1. Retrieve your [API URL](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/integrate-using-discover-rest-apis/integrate-using-the-events-api/getting-started-with-the-events-api/api-endpoints-and-methods.md "API endpoints and methods").
2. Create the [`widget click` event object](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/integrate-using-discover-rest-apis/integrate-using-the-events-api/getting-started-with-the-events-api/generic-widget-events.md "Generic widget events") as shown in the following code:

    ```JSON
    {    
      "value": {        
        "context": {
          "geo": <geo object>,
          "browser": <browser object>
        }        
        "rfkid": "<widget rfkid>"           
      },    
      "type": "widget",    
      "name": "click",    
      "t": 1625144306397,    
      "t0": 1625144306397,
      "uuid": "<Discover UUID>",    
      "user_id": "<anonymous user ID>"
    }
    ```

    > [!important]
    > You must provide either `uuid` or `user_id`.

3. Send the event object to your Events API URL as shown in the following code sample:

    ```shell
    POST {EVENT_URL}
    {
     "data": "{<event object goes here>}"
    }
    ```