---
title: "Sending events"
slug: "sending-events"
abstract: "Overview of collecting and sending behavioral data to Sitecore CDP using the Stream API."
---
# Sending events

The Stream API lets you collect and send behavioral data to Sitecore CDP in real time. The behavioral data can include a guest's page views, clicks, searches, and identifiers.

> [!note]
> To capture data in JavaScript or TypeScript web applications, we recommend that you use either [Sitecore Cloud SDK or the Engage SDK](https://doc.sitecore.com/cdp/en/developers/api/before-you-start-sending-data/integrating-with-sitecore-cdp.html "Integrating with Sitecore CDP"). These SDKs use the Stream API behind the scenes and let you easily capture data in your web app.

Your organization can send additional, custom data with events and use that data in batch segmentation and audience exports.

To ensure that you can access view the event data in the Sitecore CDP UI and use the data elsewhere in Sitecore CDP, including custom data, you must model the event object, and the optional event data extensions and custom events, according to your organization's integration:

::::tabs
:::tab{title="2.1"}

- If your organization is using the Engage SDK to integrate, follow the schema for [modelling the event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object.html "Event data object").

    To send additional, custom data with the event, follow the schema for [extending the event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/extension-data-object.html "Extension data object").

    To send a custom event, follow the schema for [modelling the custom event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/custom-event.html "Custom event").

- If your organization is not using the Engage SDK to integrate, follow the schema for [modelling the event data object](https://doc.sitecore.com/cdp/en/developers/api/before-you-start-sending-data/sending-events-1166442.html#UUID-7b39a1ba-97bc-2a94-7753-431b57155fa8_section-idm4640408171902433375375438664 "Required attributes").

    To send additional, custom data with the event, follow the schema for [extending the event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/send-additional-event-data.html "Send additional event data").

    To send a custom event, follow the schema for [modelling the custom event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/custom-event-1166461.html "Custom event").

:::
:::tab{title="2.0"}

- If your organization is using the Engage SDK to integrate, follow the schema for [modelling the event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object.html "Event data object").

    To send additional, custom data with the event, follow the schema for [extending the event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/extension-data-object.html "Extension data object").

    To send a custom event, follow the schema for [modelling the custom event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/custom-event.html "Custom event").

- If your organization is not using the Engage SDK to integrate, follow the schema for [modelling the event data object](https://doc.sitecore.com/cdp/en/developers/api/before-you-start-sending-data/sending-events-1166442.html#UUID-7b39a1ba-97bc-2a94-7753-431b57155fa8_section-idm4640408171902433375375438664 "Required attributes").

    To send a custom event, follow the schema for [modelling the custom event data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/custom-event-1166461.html "Custom event").

:::::::