Catálogo de eventos

Cuando creas un webhook, eliges qué eventos recibe. Esta página enumera todos los eventos disponibles, explica cuándo se envía cada uno y describe el formato de los mensajes.

Formato del mensaje

Todos los mensajes tienen el mismo sobre. Solo cambian el type y el contenido de data de un evento a otro.

{
  "uuid": "6c1f0f8e-4f5b-4a53-9d0e-2b7c9a1e3f42",
  "organizationsUuid": "0d5a7e3c-8b1f-4c2e-a6d9-5f4e3b2a1c0d",
  "timestamp": "2026-10-13T14:32:05.123Z",
  "type": "group_assignment.created",
  "data": {
    "groupAssignmentsUuid": "f1e2d3c4-b5a6-4978-8695-a4b3c2d1e0f9",
    "groupsUuid": "9a8b7c6d-5e4f-4321-9876-0fedcba98765"
  }
}

Campo	Descripción
uuid	Identificador único del evento. Es el mismo valor que la cabecera webhook-id y nunca cambia entre reintentos. Guárdalo para detectar duplicados.
organizationsUuid	La organización en la que ocurrió el evento. Compruébalo antes de procesar el mensaje.
timestamp	Cuándo ocurrió el evento, en formato ISO 8601 y en UTC. No cambia entre reintentos.
type	El tipo de evento, con la forma recurso.acción, por ejemplo membership.created. Consulta la lista de eventos.
data	Los identificadores de los recursos implicados. Los campos dependen del tipo de evento.

Solo identificadores, nunca todos los detalles

Los mensajes incluyen, a propósito, solo identificadores, nunca nombres, correos electrónicos ni otros atributos. Cuando tu sistema necesita más información, la lee de la API de BreezeAuth con esos identificadores. Este enfoque:

• mantiene los datos personales fuera de los mensajes, los registros y las colas;
• garantiza que tu sistema actúe siempre sobre el estado actual, aunque los mensajes lleguen tarde, repetidos o desordenados;
• mantiene los mensajes pequeños y estables cuando se añaden nuevos atributos al producto.

Cuando un evento afecta a un recurso que vive dentro de otro, data también incluye el identificador del recurso padre. Por ejemplo, una asignación de aplicación viene acompañada del identificador de su aplicación, porque ambos son necesarios para leer la asignación desde la API.

Eventos disponibles

En el campo Eventos de la consola de administración, los eventos aparecen con nombres legibles, como Membresía creada. En los mensajes, el campo type usa el nombre técnico, como membership.created.

Membresías (usuarios)

Una membresía es el vínculo de un usuario con tu organización. Consulta Conceptos de IAM.

Evento	Se envía cuando	Campos de data
membership.created	Un usuario se une a la organización (invitado, aprovisionado o creado).	membershipsUuid
membership.updated	Cambia el perfil, el rol o el estado de un usuario, como una suspensión.	membershipsUuid
membership.deleted	Se elimina a un usuario de la organización.	membershipsUuid

Grupos

Evento	Se envía cuando	Campos de data
group.created	Se crea un grupo.	groupsUuid
group.updated	Cambian los datos de un grupo, como su nombre.	groupsUuid
group.deleted	Se elimina un grupo.	groupsUuid

Cuando se elimina un grupo, sus asignaciones de aplicación se eliminan con él, y no se envían eventos application_assignment.deleted independientes para ellas. Trata group.deleted como el fin de cualquier acceso a aplicaciones concedido a través de ese grupo.

Asignaciones de grupo

Una asignación de grupo convierte a un usuario, o a otro grupo, en miembro de un grupo. Consulta Miembros del grupo.

Evento	Se envía cuando	Campos de data
group_assignment.created	Se añade un miembro a un grupo.	groupAssignmentsUuid, groupsUuid
group_assignment.deleted	Se quita un miembro de un grupo.	groupAssignmentsUuid, groupsUuid

groupsUuid identifica el grupo que ha ganado o perdido el miembro.

Con los grupos anidados, también se envían eventos para las pertenencias indirectas: añadir el grupo “Backend” a “Ingeniería” envía un evento group_assignment.created para “Backend” y uno por cada uno de sus miembros que pasa a ser miembro de “Ingeniería”. No se envía ningún evento cuando una pertenencia existente solo cambia entre directa e indirecta.

Aplicaciones

Evento	Se envía cuando	Campos de data
application.created	Se registra una aplicación en la organización.	applicationsUuid
application.updated	Cambia la configuración de una aplicación.	applicationsUuid
application.deleted	Se elimina una aplicación.	applicationsUuid

Asignaciones de aplicación

Una asignación de aplicación da a un usuario o grupo acceso a una aplicación.

Evento	Se envía cuando	Campos de data
application_assignment.created	Se da acceso a una aplicación a un usuario o grupo.	applicationAssignmentsUuid, applicationsUuid
application_assignment.updated	Cambia una asignación, por ejemplo sus roles o atributos.	applicationAssignmentsUuid, applicationsUuid
application_assignment.deleted	Se retira el acceso de un usuario o grupo a una aplicación.	applicationAssignmentsUuid, applicationsUuid

Dominios

Evento	Se envía cuando	Campos de data
domain.created	Se añade un dominio a la organización.	domainsUuid
domain.updated	Cambia un dominio, por ejemplo cuando se completa su verificación.	domainsUuid
domain.deleted	Se elimina un dominio.	domainsUuid

Sobre los eventos de actualización

Los eventos *.updated solo se envían cuando cambia algo relevante. Los cambios internos de control, como modificar únicamente la fecha de actualización de un registro, no generan eventos.

Un mensaje de actualización no indica qué campos han cambiado. Si tu sistema necesita reaccionar a un cambio concreto, como el departamento de un usuario, guarda una copia de los valores que le interesan y compáralos con los datos actuales de la API.

Elegir los eventos

Suscríbete solo a los eventos que el sistema receptor utiliza de verdad. Menos eventos significan menos tráfico para tu endpoint y un historial de eventos más claro. Aun así, tu endpoint debe responder 2xx a cualquier tipo de evento que no reconozca, porque en el futuro pueden añadirse nuevos tipos y quizá te suscribas a ellos más adelante.