Eventos de Webhooks

Esta guía enumera los diferentes eventos de webhook de Logto y explica cuándo ocurre cada evento.

Eventos de interacción del usuario

Tipo de evento	Descripción
PostRegister	Un usuario crea exitosamente una nueva cuenta a través de la interfaz de usuario.
PostSignIn	Un usuario inicia sesión exitosamente a través de la interfaz de usuario.
PostResetPassword	La contraseña de un usuario se restablece exitosamente a través del flujo de "Olvidé mi contraseña".

Eventos de mutación de datos

Usuario

Tipo de evento	Descripción
User.Created	Se crea una nueva cuenta de usuario.
User.Deleted	Se elimina una cuenta de usuario.
User.Data.Updated	Se actualizan los datos del perfil del usuario, por ejemplo, correo electrónico, avatar, custom.data, identificador social, etc.
User.SuspensionStatus.Updated	Se cambia el estado de suspensión del usuario (suspendido o reactivado).

Rol

Tipo de evento	Descripción
Role.Created	Se crea un nuevo rol.
Role.Deleted	Se elimina un rol.
Role.Data.Updated	Se actualizan los datos de un rol, por ejemplo, nombre del rol, descripción y estado de rol predeterminado.
Role.Scopes.Updated	Se añaden o eliminan permisos asignados a un rol.

Permiso (Alcance)

Tipo de evento	Descripción
Scope.Created	Se crea un nuevo permiso de API.
Scope.Deleted	Se elimina un permiso de API.
Scope.Data.Updated	Se actualizan los datos de un permiso de API, por ejemplo, la descripción del permiso.

Organización

Tipo de evento	Descripción
Organization.Created	Se crea una nueva organización.
Organization.Deleted	Se elimina una organización.
Organization.Data.Updated	Se actualizan los datos de una organización, por ejemplo, nombre de la organización, descripción, custom.data, etc.
Organization.Membership.Updated	Se añaden o eliminan miembros de una organización.

Rol de la organización

Tipo de evento	Descripción
OrganizationRole.Created	Se crea un nuevo rol de organización.
OrganizationRole.Deleted	Se elimina un rol de organización.
OrganizationRole.Data.Updated	Se actualizan los datos de un rol de organización, por ejemplo, nombre y descripción del rol de organización.
OrganizationRole.Scopes.Updated	Se añaden o eliminan permisos asignados a un rol de organización.

Permiso de la organización (alcance)

Tipo de evento	Descripción
OrganizationScope.Created	Se crea un nuevo permiso de organización.
OrganizationScope.Deleted	Se elimina un permiso de organización.
OrganizationScope.Data.Updated	Se actualizan los datos de un permiso de organización, por ejemplo, la descripción del permiso de organización.

Eventos desencadenados por la Management API

Endpoint de API	Evento
POST /users	User.Created
DELETE /users/:userId	User.Deleted
PATCH /users/:userId	User.Data.Updated
PATCH /users/:userId/custom-data	User.Data.Updated
PATCH /users/:userId/profile	User.Data.Updated
PATCH /users/:userId/password	User.Data.Updated
PATCH /users/:userId/is-suspended	User.SuspensionStatus.Updated
POST /roles	Role.Created, (Role.Scopes.Update)
DELETE /roles/:id	Role.Deleted
PATCH /roles/:id	Role.Data.Updated
POST /roles/:id/scopes	Role.Scopes.Updated
DELETE /roles/:id/scopes/:scopeId	Role.Scopes.Updated
POST /resources/:resourceId/scopes	Scope.Created
DELETE /resources/:resourceId/scopes/:scopeId	Scope.Deleted
PATCH /resources/:resourceId/scopes/:scopeId	Scope.Data.Updated
POST /organizations	Organization.Created
DELETE /organizations/:id	Organization.Deleted
PATCH /organizations/:id	Organization.Data.Updated
PUT /organizations/:id/users	Organization.Membership.Updated
POST /organizations/:id/users	Organization.Membership.Updated
DELETE /organizations/:id/users/:userId	Organization.Membership.Updated
POST /organization-roles	OrganizationRole.Created, (OrganizationRole.Scopes.Updated)
DELETE /organization-roles/:id	OrganizationRole.Deleted
PATCH /organization-roles/:id	OrganizationRole.Data.Updated
POST /organization-scopes	OrganizationScope.Created
DELETE /organization-scopes/:id	OrganizationScope.Deleted
PATCH /organization-scopes/:id	OrganizationScope.Data.Updated
PUT /organization-roles/:id/scopes	OrganizationRole.Scopes.Updated
POST /organization-roles/:id/scopes	OrganizationRole.Scopes.Updated
DELETE /organization-roles/:id/scopes/:organizationScopeId	OrganizationRole.Scopes.Updated

Eventos desencadenados por la Interaction API

Acción de interacción del usuario	Evento
Enlace de correo electrónico/teléfono del usuario	User.Data.Updated
Enlace de MFAs del usuario	User.Data.Updated
Enlace social/SSO del usuario	User.Data.Updated
Restablecimiento de contraseña del usuario	User.Data.Updated
Registro de usuario	User.Created

Preguntas frecuentes

¿Cuál es la diferencia entre PostRegister y User.Created?

PostRegister se activa cuando un usuario crea exitosamente una nueva cuenta a través del flujo de registro de usuario; User.Created se activa cuando se crea una nueva cuenta de usuario a través de la Management API.