Eliminar usuarios

Utiliza este endpoint para eliminar cualquier perfil de usuario especificando un identificador de usuario conocido.

Se pueden incluir hasta 50 external_ids, user_aliases, braze_ids, email_addresses o phone_numbers en una sola solicitud. Solo se puede incluir uno de los siguientes tipos de identificador en una misma solicitud: external_ids, user_aliases, braze_ids, email_addresses o phone_numbers.

Si tienes un caso de uso que no se puede resolver con la eliminación masiva de usuarios a través de la API, ponte en contacto con el equipo de soporte de Braze para obtener ayuda.

Advertencia

La eliminación de perfiles de usuario no se puede deshacer. La acción de eliminación borra a los usuarios de forma permanente, lo que puede causar discrepancias en tus datos. Para más detalles, consulta la sección Efectos de eliminar perfiles de usuario de la referencia de este endpoint.

Solución de problemas

Se devolvió una respuesta correcta, pero el usuario sigue apareciendo

Una respuesta correcta confirma que la solicitud se puso en cola, no que la eliminación se haya completado. La eliminación suele terminar en menos de un segundo, pero el cambio puede tardar hasta cinco minutos en propagarse por todas las cachés. Si buscas al usuario en el panel inmediatamente o exportas sus datos a través de la API, es posible que sigas viendo resultados durante este periodo de propagación.

Si el usuario sigue existiendo después de varios minutos, verifica que el identificador de tu solicitud coincida con el perfil real del usuario:

• Matriz external_ids: Confirma que cada valor coincida exactamente con el ID externo de un usuario.
• braze_id: Puedes encontrar el braze_id de un usuario exportando sus datos con el endpoint /users/export/ids o exportando un segmento a CSV (donde el braze_id aparece como “Appboy ID”).
• Perfiles solo con alias o solo con correo electrónico: Si el perfil no tiene external_id, crea un segmento que filtre por External User ID is blank combinado con el correo electrónico o el número de teléfono conocido y, después, expórtalo a CSV para obtener el braze_id.

Para confirmar si un usuario se ha eliminado, llama al endpoint /users/export/ids con el mismo tipo de identificador que usaste en la solicitud de eliminación (por ejemplo, incluyendo el valor en external_ids, braze_id o user_aliases). Si el usuario ya no existe, la respuesta contiene "users": [] y puede incluir "invalid_user_ids" con ese identificador.

Puedes descargar el documento OpenAPI y usarlo para validar esquemas. Para saber cómo hacerlo, consulta Usar esquemas OpenAPI para validar solicitudes.