> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-docs-applications-ia-reorg.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Types

> Understand the the cloud events schema Auth0 uses to publish event objects, including required fields and the user event data payload, so you can build event streams that listen for supported event types.

You can create event streams that listen for different types of events, such as the creation of a new user profile. The sections below outline specific details for currently supported event types.

## Event object

Events are published using a schema that conforms to the [CloudEvent specification](https://cloudevents.io/):

| Parameter   | Type          | Required | Description                                                                                |
| ----------- | ------------- | -------- | ------------------------------------------------------------------------------------------ |
| id          | string        | Yes      | Identifies the event.                                                                      |
| source      | URI-reference | Yes      | Identifies the tenant that generated the event, including its environment.                 |
| specversion | string        | Yes      | The version of the CloudEvents specification that the event uses.                          |
| type        | string        | Yes      | The type of event.                                                                         |
| time        | timestamp     | Yes      | Timestamp of when the event happened.                                                      |
| dataschema  | URI           | Yes      | Identifies the schema that data adheres to.                                                |
| data        | object        | Yes      | Additional information related to the event. This field varies based on the type of event. |

```json lines expandable theme={null}
{
  "id": "evt_<unique-id>",
  "source": "urn:auth0:<your-tenant>:users",
  "spec_version": "1.0",
  "type": "com.auth0.user.<event-type>",
  "time": "2025-01-29T14:36:25.794Z",
  "dataschema": "https://<your-tenant>.auth0.com/api/v2/schemas/user.<event-type>",
  "data": {
    "object": {
      "user_id": "<user-id>",
      "email": "<email>",
      "email_verified": <true/false>,
      "family_name": "<family-name>",
      "given_name": "<given-name>",
      "name": "<full-name>",
      "nickname": "<nickname>",
      "phone_number": "<phone-number>",
      "phone_verified": <true/false>,
      "user_metadata": {
        "hobby": "<user-hobby>"
      },
      "app_metadata": {
        "external_user_id": "<external-id>"
      },
      "identities": [
        {
          "connection": "<connection-name>",
          "user_id": "<identity-user-id>",
          "provider": "<identity-provider>",
          "isSocial": <true/false>
        }
      ],
      "created_at": "<user-created-time>",
      "updated_at": "<user-updated-time>",
      "picture": "<profile-picture-url>"
    }
  }
}
```

For more information on Event Types, see the [Events Catalog](https://auth0.com/docs/events/).

## Learn more

* [Create an Event Stream](/docs/customize/events/create-an-event-stream)
* [Event Testing, Observability, and Failure Recovery](/docs/customize/events/event-testing-observability-and-failure-recovery)
* [Events Best Practices](/docs/customize/events/events-best-practices)