---
title: "identity"
slug: "cloud-sdk-events-server-identity"
abstract: "The identity function sends an IDENTITY event from the server side."
---
# identity

|     |     |
| --- | --- |
| Type | Function |
| Import path | `@sitecore-cloudsdk/events/server` |

Sends an [`IDENTITY`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events/identity-events.html "IDENTITY events") event.

## Signature

```typescript
export function identity(
  request: Request,
  identityData: IdentityData
): Promise<EPResponse | null>
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `request` | `Request` | Required.<br><br>The HTTP request. |
| `identityData` | [`IdentityData`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-browser/interfaces/cloud-sdk-events-identitydata.html "IdentityData") | Required.<br><br>Data for [`IDENTITY`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events/identity-events.html "IDENTITY events") events. |

## Return value

Returns a promise.

## Examples

:::tab{title="Next.js"}

Example 47. Running the identity function

:::tab{title="Next.js"}
> [!note]
> To run this function, you have to first [initialize](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-server/functions/cloud-sdk-core-server-cloudsdk.html "CloudSDK") the Cloud SDK.
>
> See [more examples](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-server/functions/identity-events.html "IDENTITY events") and [other data](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-server/functions/cloud-sdk-events-identitydata.html "IdentityData") you can include in the event.

Here's an example of how to use the `identity` function:

```typescript
import type { NextRequest } from "next/server";
import { NextResponse } from "next/server";
import { CloudSDK } from "@sitecore-cloudsdk/core/server";
import { identity } from "@sitecore-cloudsdk/events/server";

export default async function middleware(request: NextRequest) {
  const response = NextResponse.next();

  // Initialize the SDK and the package...

  // Send event:
  const eventData: any = {
    identifiers: [
        {
            id: "123456",
            provider: "BXLP"
        }
    ]
  };

  const identityResponse = await identity(request, eventData);
  console.log("Sent IDENTITY event.", identityResponse);

  return response;
};
```

:::

:::