Event Types

Events are currently available in Early Access.To learn more about Auth0’s product release cycle, review Product Release Stages.

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

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 , bulk user imports, SCIM, or just-in-time provisioning (JIT), for Social, Enterprise, or 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"
    }
  }
}

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

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

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

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

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

organization.updated

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

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

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

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

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

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

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

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

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

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

Brand Customization

Code Customization

Third-Party Customization

Event Types

Event object

User event types

user.created

user.updated

user.deleted

Organization event types

organization.created

organization.updated

organization.deleted

organization.member.added

organization.member.deleted

organization.member.role.assigned

organization.member.role.deleted

organization.connection.added

organization.connection.updated

organization.connection.removed

Learn more

Brand Customization

Code Customization

Third-Party Customization

​Event object

​User event types

​user.created

​user.updated

​user.deleted

​Organization event types

​organization.created

​organization.updated

​organization.deleted

​organization.member.added

​organization.member.deleted

​organization.member.role.assigned

​organization.member.role.deleted

​organization.connection.added

​organization.connection.updated

​organization.connection.removed

​Learn more

Event object

User event types

user.created

user.updated

user.deleted

Organization event types

organization.created

organization.updated

organization.deleted

organization.member.added

organization.member.deleted

organization.member.role.assigned

organization.member.role.deleted

organization.connection.added

organization.connection.updated

organization.connection.removed

Learn more