---
title: "IDENTITY event"
slug: "identity-event"
abstract: "Describes the event data object for an IDENTITY event in the Sitecore Engage SDK (Sitecore CDP Stream API)."
---
# IDENTITY event

The event data object for an IDENTITY event must include all the [required attributes for event data objects](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object.html#UUID-a7f441ce-7bee-9e1a-8a6c-7f995310e71b_UUID-2cda931f-8a8a-520d-dd7c-fe7fa3c3d597 "Required attributes") plus the following attributes:

- Attribute: Type
- `identifiers`: array of objects

The `identifiers` array of objects:

| Attribute | Type | Description | Example | Required/optional |
| --- | --- | --- | --- | --- |
| `id` | string | The unique guest identifier provided by your organization's identity system, such as a Customer Relationship Management (CRM) system. | `"123456"` | Required |
| `provider` | string | The name of your organization's identity system, external to Sitecore CDP, that provided the unique guest identifier. | `"BXLP"` | Required |
| `expiryDate` | string ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) | The date the unique guest identifier expires. This is determined by your organization's identity system. | `"2026-04-15T08:`39:44`.868Z"` | Optional |

The object can optionally include personally identifiable information (PII):

| Attribute | Type | Description | Example |
| --- | --- | --- | --- |
| `email` | string (lowercase recommended) | The email address of the guest. | `"jane.doe@myretailsite.com"` |
| `title` | string (title case) | The title of the guest. | <ul><li>`"Miss"`</li><li>`"Mr"`</li><li>`"Mrs"`</li><li>`"Ms"`</li></ul> |
| `firstName` | string (title case recommended) | The first name of the guest. | `"Jane"` |
| `lastName` | string (title case recommended) | The last name of the guest. | `"Doe"` |
| `gender` | string | The gender of the guest. | `"female"` |
| `dob` | string ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) | The date of birth of the guest. | `"1983-04-15T00:00"` |
| `mobile` | string | The mobile number of the guest. | `"+3531234567"` |
| `phone` | string | The phone number of the guest. | `"+3531234567"` |
| `street` | array of strings (title case recommended) | The street address of the guest. | `["Tara Street"]` |
| `city` | string (title case recommended) | The city address of the guest. | `"Dublin"` |
| `state` | string (title case recommended) | The state address of the guest. | `"Oregon"` |
| `country` | string (uppercase [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1)) | The country address of the guest. | `"IE"` |
| `postalCode` | string | The postal code of the guest. | `"D2"` |

After you create this event data object, you can optionally extend this event using the [extension data object](https://doc.sitecore.com/cdp/en/developers/api/stream-api/sitecore-engage-sdk-reference/objects/extension-data-object.html "Extension data object"). Then, you can send the event using the `[Engage.identity()](../../functions/engage-identity.md "Engage.identity(eventData[, extensionData])")` function.

Here's an example of the event data object for an IDENTITY event. This event data object contains the `identifiers` array of objects and the following, optional PII attributes: `email`, `firstName`, `lastName`.

```javascript
const eventData = {
    channel: "WEB",
    currency: "EUR",
    pointOfSale: "myretailsite/ireland",
    language: "EN",
    page: "home",
    email: "jane.doe@myretailsite.com",
    firstName: "Jane",
    lastName: "Doe",
    identifiers: [
        {
            id: "123456",
            provider: "BXLP"
        }
    ]
}

```