> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.

> Learn more about supported Event types.

# Event Types

<Warning>
  **Events are currently available in Early Access**.

  To learn more about Auth0's product release cycle, review [Product Release Stages](/docs/troubleshoot/product-lifecycle/product-release-stages).
</Warning>

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/):

<table class="table">
  <thead>
    <tr>
      <th><strong>Parameter</strong></th>
      <th><strong>Type</strong></th>
      <th><strong>Required</strong></th>
      <th><strong>Description</strong></th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>id</td>
      <td>string</td>
      <td>Yes</td>
      <td>Identifies the event.</td>
    </tr>

    <tr>
      <td>source</td>
      <td>URI-reference</td>
      <td>Yes</td>
      <td>Identifies the tenant that generated the event, including its environment.</td>
    </tr>

    <tr>
      <td>specversion</td>
      <td>string</td>
      <td>Yes</td>
      <td>The version of the CloudEvents specification that the event uses.</td>
    </tr>

    <tr>
      <td>type</td>
      <td>string</td>
      <td>Yes</td>
      <td>The type of event.</td>
    </tr>

    <tr>
      <td>time</td>
      <td>timestamp</td>
      <td>Yes</td>
      <td>Timestamp of when the event happened.</td>
    </tr>

    <tr>
      <td>dataschema</td>
      <td>URI</td>
      <td>Yes</td>
      <td>Identifies the schema that data adheres to.</td>
    </tr>

    <tr>
      <td>data</td>
      <td>object</td>
      <td>Yes</td>
      <td>Additional information related to the event. This field varies based on the type of event.</td>
    </tr>
  </tbody>
</table>

```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>"
    }
  }
}
```

## User event types

When creating an event stream, you can subscribe to the following user events:

<table class="table">
  <thead>
    <tr>
      <th><strong>Event</strong></th>
      <th><strong>Description</strong></th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>user.created</code></td>
      <td>Published each time a user is created. This event captures users created through a variety of channels, such as a signup page, the Auth0 Management API, custom signup forms, bulk user imports, SCIM, or JIT (for Social, Enterprise, or Passwordless connections).</td>
    </tr>

    <tr>
      <td><code>user.updated</code></td>
      <td>Published each time a user is updated. This event captures user updates made through a variety of channels, such as the Auth0 Management API, bulk user imports, SCIM, or JIT (for Social, Enterprise, or Passwordless connections).</td>
    </tr>

    <tr>
      <td><code>user.deleted</code></td>
      <td>Published each time a user is deleted. This event captures user deletions made through the Management API or as a result of deleting a connection.</td>
    </tr>
  </tbody>
</table>

### user.created

`user.created` events are published each time a user is created. These events capture users created through a variety of channels, such as a signup page, the <Tooltip tip="Management API: A product to allow customers to perform administrative tasks." cta="View Glossary" href="/docs/glossary?term=Management+API">Management API</Tooltip>, bulk user imports, SCIM, or just-in-time provisioning (JIT), for Social, Enterprise, or <Tooltip tip="Passwordless: Form of authentication that does not rely on a password as the first factor." cta="View Glossary" href="/docs/glossary?term=Passwordless">Passwordless</Tooltip> connections.

```json lines expandable theme={null}
{
  "id": "evt_xxxxxxxx", 
  "source": "https://auth0.com/docs/v1beta1/user.created",
  "specversion": "v1beta1",
  "type": "user.created",
  "time": "2025-01-29T21:02:03.873Z",
  "data": {
    "object": {
      "created_at": "2025-01-29T21:02:03.87Z",
      "email": "user@example.com",
      "email_verified": false,
      "identities": [
        {
          "connection": "Username-Password-Authentication",
          "user_id": "xxxxxxxxxxxx",
          "provider": "auth0",
          "isSocial": false
        }
      ],
      "name": "user@example.com",
      "nickname": "user123",
      "picture": "example.png",
      "updated_at": "2025-01-29T21:02:03.87Z",
      "user_id": "auth0|xxxxxxxxxxxx",
      "app_metadata": {
        "custom_claim": "value"
      },
      "user_metadata": {
        "favorite_color": "blue",
        "preferred_language": "en"
      },
      "blocked": false,
      "last_login": "2025-01-29T21:02:03.87Z",
      "logins_count": 1,
      "phone_number": "+1234567890",
      "phone_verified": false,
      "multifactor": ["google-authenticator"],
      "last_ip": "192.168.1.1",
      "email_verified_at": "2025-01-29T21:02:03.87Z",
      "given_name": "John",
      "family_name": "Doe"
    }
  }
}
```

Review the following sections for examples based on different methods of user creation.

<Tabs>
  <Tab title="Database signup with UL">
    **Scenario**: A user signs up through a Universal Login prompt using a database connection.

    ```json lines expandable theme={null}
    {
      "specversion": "1.0",
      "type": "user.created",
      "source": "urn:auth0:example.auth0app.com",
      "id": "evt_1234567890abcdef",
      "time": "2025-02-01T12:34:56Z",
      "data": {
        "object": {
          "user_id": "auth0|507f1f77bcf86cd799439020",
          "email": "john.doe@gmail.com",
          "email_verified": false,
          "username": "johndoe",
          "phone_number": "+15555555555",
          "phone_verified": false,
          "created_at": "2025-02-01T12:34:56Z",
          "updated_at": "2025-02-01T12:34:56Z",
          "identities": [
            {
              "provider": "auth0",
              "isSocial": false,
              "connection": "Username-Password-Authentication",
              "user_id": "507f1f77bcf86cd799439020",
              "profileData": {
                "email": "john.doe@gmail.com",
                "email_verified": false,
                "name": "John Doe",
                "username": "johndoe",
                "given_name": "John",
                "family_name": "Doe",
                "phone_number": "+15555555555",
                "phone_verified": false
              }
            }
          ],
          "app_metadata": {
            "plan": "pro"
          },
          "user_metadata": {
            "hobby": "skydiving"
          },
          "picture": "https://secure.gravatar.com/avatar/15626c5e0c749cb912f9d1ad48dba440?s=480&r=pg&d=https%3A%2F%2Fssl.gstatic.com%2Fs2%2Fprofiles%2Fimages%2Fsilhouette80.png",
          "name": "John Doe",
          "nickname": "John Doe",
          "multifactor": [
            "sample"
          ],
          "last_ip": "10.0.0.1",
          "last_login": "2025-02-01T12:34:56Z",
          "logins_count": 42,
          "blocked": false,
          "given_name": "John",
          "family_name": "Doe"
        }
      },
      "a0tenant": "my-tenant",
      "a0stream": "est_1234567890abcdef"
    }
    ```
  </Tab>

  <Tab title="Signup with Mgmt API">
    **Scenario**: A user associated with a database connection is created through the Management API.

    ```json lines expandable theme={null}
    {
      "id": "evt_987654321",
      "source": "https://auth0.com/docs/v1beta1/user.created",
      "specversion": "v1beta1",
      "type": "user.created",
      "time": "2025-01-29T22:00:00.000Z",
      "data": {
        "object": {
          "created_at": "2025-01-29T22:00:00.000Z",
          "email": "admin-created@example.com",
          "email_verified": false,
          "identities": [
            {
              "connection": "Username-Password-Authentication",
              "user_id": "auth0|admin123",
              "provider": "auth0",
              "isSocial": false
            }
          ],
          "user_id": "auth0|admin123",
          "app_metadata": {
            "created_by": "admin"
          },
          "user_metadata": {
            "source": "management_api"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Social connection">
    **Scenario**: A user signs up using a social connection such as Google.

    ```json lines expandable theme={null}
    {
      "id": "evt_google123",
      "source": "https://auth0.com/docs/v1beta1/user.created",
      "specversion": "v1beta1",
      "type": "user.created",
      "time": "2025-01-30T00:30:00.000Z",
      "data": {
        "object": {
          "created_at": "2025-01-30T00:30:00.000Z",
          "email": "googleuser@example.com",
          "email_verified": true,
          "identities": [
            {
              "connection": "google-oauth2",
              "user_id": "9876543210",
              "provider": "google-oauth2",
              "isSocial": true
            }
          ],
          "name": "Google User",
          "nickname": "guser",
          "user_id": "google-oauth2|9876543210",
          "app_metadata": {},
          "user_metadata": {
            "signup_source": "google"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="SAML SCIM">
    **Scenario**: A user signs up through a SAML SCIM connection.

    ```json lines expandable theme={null}
    {
      "id": "evt_saml_scim123",
      "source": "https://auth0.com/docs/v1beta1/user.created",
      "specversion": "v1beta1",
      "type": "user.created",
      "time": "2025-01-30T02:10:00.000Z",
      "data": {
        "object": {
          "created_at": "2025-01-30T02:10:00.000Z",
          "email": "samluser@example.com",
          "email_verified": true,
          "identities": [
            {
              "connection": "my-saml-idp",
              "user_id": "SAML-67890",
              "provider": "samlp",
              "isSocial": false
            }
          ],
          "user_id": "samlp|SAML-67890",
          "app_metadata": {
            "provisioned_by": "scim"
          },
          "user_metadata": {
            "signup_source": "saml_scim"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

### user.updated

`user.updated` events are published each time a user is updated. These events capture user updates made through a variety of channels, such as the user themselves after logging in, the Management API, bulk user imports (upsert), SCIM, or just-in-time provisioning (JIT), for Social, Enterprise, or Passwordless connections.

```json lines expandable theme={null}
{
  "specversion": "1.0",
  "type": "user.updated",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "user_id": "auth0|507f1f77bcf86cd799439020",
      "email": "john.doe@gmail.com",
      "email_verified": false,
      "username": "johndoe",
      "phone_number": "+15555555555",
      "phone_verified": false,
      "created_at": "2025-02-01T12:34:56Z",
      "updated_at": "2025-02-01T12:34:56Z",
      "identities": [
        {
          "provider": "auth0",
          "isSocial": false,
          "connection": "Username-Password-Authentication",
          "user_id": "507f1f77bcf86cd799439020",
          "profileData": {
            "email": "john.doe@gmail.com",
            "email_verified": false,
            "name": "John Doe",
            "username": "johndoe",
            "given_name": "John",
            "family_name": "Doe",
            "phone_number": "+15555555555",
            "phone_verified": false
          }
        }
      ],
      "app_metadata": {
        "plan": "pro"
      },
      "user_metadata": {
        "hobby": "skydiving"
      },
      "picture": "https://secure.gravatar.com/avatar/15626c5e0c749cb912f9d1ad48dba440?s=480&r=pg&d=https%3A%2F%2Fssl.gstatic.com%2Fs2%2Fprofiles%2Fimages%2Fsilhouette80.png",
      "name": "John Doe",
      "nickname": "John Doe",
      "multifactor": [
        "sample"
      ],
      "last_ip": "10.0.0.1",
      "last_login": "2025-02-01T12:34:56Z",
      "logins_count": 42,
      "blocked": false,
      "given_name": "John",
      "family_name": "Doe"
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### user.deleted

`user.deleted` events publish each time a user is deleted. These events capture users deleted through the Management API or when a connection is deleted.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "user.deleted",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "user_id": "auth0|507f1f77bcf86cd799439020",
      "deleted_at": "2025-02-01T12:34:56Z"
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

## Organization event types

When creating an event stream, you can subscribe to the following user events:

<table class="table">
  <thead>
    <tr>
      <th><strong>Event</strong></th>
      <th><strong>Description</strong></th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>organization.created</code></td>
      <td>Published each time an organization is created.</td>
    </tr>

    <tr>
      <td><code>organization.updated</code></td>
      <td>Published each time an organization is updated.</td>
    </tr>

    <tr>
      <td><code>organization.deleted</code></td>
      <td>Published each time an organization is deleted.</td>
    </tr>

    <tr>
      <td><code>organization.member.added</code></td>
      <td>Published each time a member is added to an organization.</td>
    </tr>

    <tr>
      <td><code>organization.member.deleted</code></td>
      <td>Published each time a member is removed from an organization.</td>
    </tr>

    <tr>
      <td><code>organization.member.role.assigned</code></td>
      <td>Published each time a role is assigned to a member within an organization.</td>
    </tr>

    <tr>
      <td><code>organization.member.role.deleted</code></td>
      <td>Published each time a role is unassigned from a member within an organization.</td>
    </tr>

    <tr>
      <td><code>organization.connection.added</code></td>
      <td>Published each time a connection is added to an organization.</td>
    </tr>

    <tr>
      <td><code>organization.connection.updated</code></td>
      <td>Published each time a connection belonging to an organization is updated.</td>
    </tr>

    <tr>
      <td><code>organization.connection.removed</code></td>
      <td>Published each time a connection is removed from an organization.</td>
    </tr>
  </tbody>
</table>

### organization.created

When a new organization is successfully created within your Auth0 tenant, an `organization.created` event is published, providing details about the newly established organization.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.created",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "display_name": "My Organization",
      "metadata": {},
      "branding": {
        "logo_url": "https://example.com",
        "colors": {
          "primary": "#0059d6",
          "page_background": "#000000"
        }
      },
      "name": "my-organization",
      "id": "org_1234567890abcdef"
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.updated

When the configuration of an existing organization is modified, an `organization.updated` event is published, containing details about the updated organization.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.updated",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "display_name": "My Organization",
      "metadata": {},
      "branding": {
        "logo_url": "https://example.com",
        "colors": {
          "primary": "#0059d6",
          "page_background": "#000000"
        }
      },
      "name": "my-organization",
      "id": "org_1234567890abcdef"
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.deleted

When an organization is removed from your Auth0 tenant, an `organization.deleted` event is published, signaling its successful deletion.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.deleted",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "display_name": "My Organization",
      "metadata": {},
      "name": "my-organization",
      "id": "org_1234567890abcdef"
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.member.added

When a new member joins an organization, an `organization.member.added` event is published, containing information about the new membership.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.member.added",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "organization": {
        "name": "my-organization",
        "id": "org_1234567890abcdef"
      },
      "user": {
        "user_id": "auth0|507f1f77bcf86cd799439020"
      },
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.member.deleted

When a member is removed from an organization, an `organization.member.deleted` event is published, signaling their successful removal.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.member.deleted",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "organization": {
        "name": "my-organization",
        "id": "org_1234567890abcdef"
      },
      "user": {
        "user_id": "auth0|507f1f77bcf86cd799439020"
      },
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.member.role.assigned

When a role is assigned to an organization member, an `organization.member.role.assigned` event is published, containing information about the new role.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.member.role.assigned",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "organization": {
        "name": "my-organization",
        "id": "org_1234567890abcdef"
      },
      "user": {
        "user_id": "auth0|507f1f77bcf86cd799439020"
      },
      "role": {
        "id": "rol_1234567890abcdef"
      }
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.member.role.deleted

When a role is unassigned from an organization member, an `organization.member.role.deleted` event is published, signaling its removal.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.member.role.deleted",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "organization": {
        "name": "my-organization",
        "id": "org_1234567890abcdef"
      },
      "user": {
        "user_id": "auth0|507f1f77bcf86cd799439020"
      },
      "role": {
        "id": "rol_1234567890abcdef"
      }
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.connection.added

When a new connection is successfully linked to an organization, an `organization.connection.added` event is published.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.connection.added",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "organization": {
        "name": "my-organization",
        "id": "org_1234567890abcdef"
      },
      "connection": {
        "id": "con_kFOHQUeaCSC1Kjqz"
      },
      "assign_membership_on_login": false,
      "show_as_button": false,
      "is_signup_enabled": false
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.connection.updated

When the configuration of an existing connection linked to an organization is modified, an `organization.connection.updated` event is published, containing information about the updated connection.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.connection.updated",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "organization": {
        "name": "my-organization",
        "id": "org_1234567890abcdef"
      },
      "connection": {
        "id": "con_kFOHQUeaCSC1Kjqz"
      },
      "assign_membership_on_login": false,
      "show_as_button": false,
      "is_signup_enabled": false
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

### organization.connection.removed

When a connection is unlinked from an organization, an `organization.connection.removed` event is published, signalling its removal.

```json lines theme={null}
{
  "specversion": "1.0",
  "type": "organization.connection.removed",
  "source": "urn:auth0:example.auth0app.com",
  "id": "evt_1234567890abcdef",
  "time": "2025-02-01T12:34:56Z",
  "data": {
    "object": {
      "organization": {
        "name": "my-organization",
        "id": "org_1234567890abcdef"
      },
      "connection": {
        "id": "con_kFOHQUeaCSC1Kjqz"
      }
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}
```

## 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)