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:

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. 
{
  "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>"
    }
  }
}

Was this helpful?

/

User event types

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

Event Description
user.created 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).
user.updated 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).
user.deleted 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.

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 Management API, bulk user imports, SCIM, or just-in-time provisioning (JIT), for Social, Enterprise, or Passwordless connections.

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

Was this helpful?

/

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

Scenario: A user signs up through a Universal Login prompt using a database connection. 

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

Was this helpful?

/

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.

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

Was this helpful?

/

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.

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

Was this helpful?

/

Organization event types

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

Event Description
organization.created Published each time an organization is created.
organization.updated Published each time an organization is updated.
organization.deleted Published each time an organization is deleted.
organization.member.added Published each time a member is added to an organization.
organization.member.deleted Published each time a member is removed from an organization.
organization.member.role.assigned Published each time a role is assigned to a member within an organization.
organization.member.role.deleted Published each time a role is unassigned from a member within an organization.
organization.connection.added Published each time a connection is added to an organization.
organization.connection.updated Published each time a connection belonging to an organization is updated.
organization.connection.removed Published each time a connection is removed from an organization.

organization.created

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

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

Was this helpful?

/

organization.updated

An organization.updated event is published whenever the configuration of an existing organization is changed. This event provides details about the modifications made.

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

Was this helpful?

/

organization.deleted

The organization.deleted event is triggered when an organization is removed from your Auth0 tenant, signaling its successful deletion.

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

Was this helpful?

/

organization.member

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

Event type Description
organization.member.role.assigned Keep track of role assignments within your organizations. The organization.member.role.assigned event is published whenever a role is granted to a member.
organization.member.role.deleted The organization.member.role.deleted event is published when a role is unassigned from a member within an organization. 

{
  "specversion": "1.0",
  "type": "organization.member.role.assigned | 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"
}

Was this helpful?

/

organization.connection

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

Event type Description
organization.connection.added Whenever a new connection is successfully linked to an organization, an organization.connection.added event is published.
organization.member.role.deleted An organization.connection.updated event is published when an existing connection's settings are changed. 

{
  "specversion": "1.0",
  "type": "organization.connection.added | 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"
      },
      "assign_membership_on_login": false,
      "show_as_button": false,
      "is_signup_enabled": false
    }
  },
  "a0tenant": "my-tenant",
  "a0stream": "est_1234567890abcdef"
}

Was this helpful?

/

organization.connection.removed

The organization.connection.removed event is triggered when a connection is unlinked from an organization.

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

Was this helpful?

/

Learn more