Glosario de códigos de error de Power Automate: los errores de HTTP y de conector más importantes

Un flujo aparece en rojo, en el historial de ejecución se muestra un código de error como 403 o un nombre interno como ActionFailed, y el propio mensaje de error no te ayuda realmente a avanzar. Justo ahí empieza la búsqueda: ¿es un problema de la conexión, de los datos de entrada o del servicio de destino? Sin una referencia, cada incidencia te cuesta un tiempo valioso, porque primero tienes que averiguar qué significa el código.

Este glosario resume los códigos de estado HTTP más importantes y los nombres de error típicos propios de Power Automate, tal como se documentan en la referencia de códigos de error para flujos en la nube oficial de Microsoft. Para cada error se explica brevemente qué significa, cuáles son las causas más frecuentes y dónde mirar primero. Simplemente busca el código que aparece en tu historial de ejecución.

Códigos de estado HTTP de un vistazo

Muchos errores de conector en Power Automate son, en el fondo, códigos de estado HTTP clásicos que devuelve la API llamada. Microsoft enumera los más frecuentes en la documentación sobre integridad de los conectores:

• 400 Bad Request: El servidor no puede o no quiere procesar la solicitud porque los datos de entrada son incorrectos.
• 401 Unauthorized: La autenticación ha fallado, faltan credenciales válidas.
• 403 Forbidden: Se ha superado un límite de solicitudes de la API o falta el permiso.
• 404 Not Found: La operación llamada ya no existe o se ha marcado como obsoleta.
• 409 Conflict: La solicitud entra en conflicto con el estado actual del recurso de destino, a menudo resoluble reenviándola tras una corrección.
• 415 Unsupported Media Type: El tipo de contenido de la solicitud no es compatible con el servidor.
• 429 Too Many Requests: Se ha alcanzado el límite de solicitudes de la API.
• 500 Internal Server Error: Un error inesperado por parte del servidor.
• 502 Bad Gateway: Un problema en el servidor web de alojamiento, a menudo una conexión cerrada.
• 504 Gateway Timeout: El servidor no responde a tiempo.
• 522, 523, 524: Errores de conexión o de tiempo de espera agotado, normalmente causados por un servicio de destino inaccesible o sobrecargado.

Es importante saber esto: los errores en el rango 400 casi siempre se deben a la propia solicitud, mientras que los errores en el rango 500 indican un problema en el servicio llamado y por lo general solo se solucionan esperando o reintentando.

Errores de conexión y autenticación

Este grupo de errores se produce cuando el flujo ya no puede iniciar sesión en un servicio conectado.

• InvalidConnection: La referencia de conexión apunta a una conexión eliminada, caducada o interrumpida. Abre el flujo, selecciona la acción afectada y vuelve a crear la conexión.
• ConnectionNotConfigured: Una acción necesita una conexión, pero no se ha seleccionado ninguna, a menudo tras importar desde una solución. Selecciona la conexión adecuada en la acción.
• ConnectionAuthorizationFailed: La conexión existe, pero sus credenciales guardadas ya no son válidas, por ejemplo porque se cambió una contraseña o un token de OAuth caducó tras 90 días de inactividad. Ve a Conexiones, selecciona la conexión afectada y usa Corregir conexión.
• Unauthorized (401): El token de autenticación no es válido o ha caducado. Comprueba además los registros de inicio de sesión en Microsoft Entra ID para ver si hay bloqueos por acceso condicional.
• Forbidden (403): El usuario o la aplicación no tiene permiso para realizar la operación. La causa más frecuente es una directiva de prevención de pérdida de datos (DLP) que bloquea el conector en el entorno, o la falta de permisos en el recurso de destino.

Según la documentación de Microsoft, para los flujos en producción merece la pena cambiar a una conexión de entidad de servicio, ya que esta no caduca cuando un empleado cambia su contraseña o abandona la empresa.

Errores de conector y de API

Estos errores provienen del propio servicio llamado, no de Power Automate.

• ActionFailed: Un mensaje de error genérico que indica que una acción ha fallado. La causa real está en el texto de salida de la acción; abre la ejecución fallida y despliega Salidas.
• BadRequest (400): Los datos de entrada tienen un formato incorrecto, por ejemplo una cadena de texto donde se espera un número, o falta un campo obligatorio en el cuerpo de la solicitud.
• NotFound (404): El recurso referenciado, por ejemplo una lista de SharePoint o una carpeta del buzón, se ha renombrado, movido o eliminado.

En los tres errores ayuda el mismo primer paso: abrir la ejecución fallida en el historial de ejecución y comparar las entradas con el formato realmente esperado.

Errores de tiempo de diseño y de expresión

Estos errores aparecen ya al guardar o solo en tiempo de ejecución, cuando se evalúa una expresión.

• InvalidTemplate: Un error de sintaxis en una expresión, a menudo paréntesis que no coinciden o un nombre de acción incorrecto.
• FlowCheckerError: El comprobador de flujos ha encontrado un problema de validación, normalmente un campo obligatorio vacío o una conexión faltante.
• DuplicateActionName: Dos acciones del mismo flujo tienen internamente el mismo nombre, a menudo tras copiar y pegar sin renombrar.
• MissingRequiredProperty: Un campo obligatorio de una acción o del desencadenador se quedó vacío.
• ExpressionEvaluationFailed: Una expresión no se puede evaluar en tiempo de ejecución porque los datos reales no coinciden con la expresión, por ejemplo al acceder a un campo de un objeto vacío. Una protección con `coalesce()` suele solucionar esto.
• ContentConversionFailed: El flujo no pudo convertir los datos de un tipo a otro, por ejemplo una fecha en un formato inesperado.

Errores de tiempo de espera y limitación

Este grupo se produce en cuanto un flujo supera los límites de tiempo o de volumen.

• ActionTimedOut: Una acción individual superó su límite de tiempo configurado; el tiempo de espera predeterminado de una acción HTTP es de 100 segundos.
• OperationTimedOut: Una operación de larga duración, como una aprobación o un webhook, superó el tiempo de espera máximo. Según la documentación, los flujos en la nube se ejecutan como máximo durante 30 días.
• WorkflowRunActionRepetitionQuotaExceeded: Un bucle como «Aplicar a cada uno» superó el número máximo de iteraciones, a menudo por bucles anidados sin filtrado previo.
• FlowRunQuotaExceeded: Se ha alcanzado el límite diario de ejecuciones de acciones para el usuario o el flujo, según el nivel de licencia.
• DirectApiAuthorizationRequired: El flujo usa un conector premium, pero el usuario que lo desencadena no tiene la licencia adecuada.

Cómo proceder de forma sistemática

En lugar de buscar cada error por separado en Google, ayuda seguir un orden fijo, tal como también describe Microsoft en la guía Solución de problemas de errores de flujos en la nube:

• Abre la ejecución fallida en el historial de ejecución e identifica la acción marcada en rojo.
• Despliega Entradas y Salidas de la acción para ver el código de estado exacto y el mensaje de error.
• Asigna el código a la categoría correspondiente de este glosario: conexión, solicitud, expresión o tiempo de espera.
• Si no encuentras el texto del error en este resumen, cópialo textualmente y búscalo en los foros de la comunidad de Power Automate, donde ya se han tratado casi todos los casos especiales.

Si un flujo en tu empresa se atasca repetidamente con los mismos códigos de error, o si no logras determinar la causa a pesar de esta referencia, lo revisamos juntos con gusto en el marco de nuestra consultoría de Power Automate. Como empleados digitales, configuramos correctamente de una vez las conexiones, el manejo de errores y la lógica de reintentos, y los documentamos para que después mantengas el control sobre tus flujos.

Preguntas frecuentes

¿Cuál es la diferencia entre un código de estado HTTP y un error como ActionFailed?

Los códigos de estado HTTP como 401 o 404 provienen directamente del servicio llamado y describen por qué falló la solicitud concreta. Los errores como ActionFailed, en cambio, son un envoltorio genérico de Power Automate, tras el cual casi siempre se esconde uno de estos códigos HTTP. Abre las salidas de la acción fallida para encontrar el código de estado real detrás de ella.

¿Por qué recibo un error 403 aunque mis credenciales son correctas?

Un 403 no significa necesariamente credenciales incorrectas, sino falta de permiso para la operación concreta. Las causas más frecuentes son una directiva de prevención de pérdida de datos que bloquea el conector en tu entorno, la falta de acceso de escritura al recurso de destino o un límite de solicitudes de la API superado. Comprueba primero los permisos en el recurso de destino y después las directivas DLP en tu entorno.

¿Cómo averiguo qué acción causó un error?

Abre el flujo afectado, selecciona la ejecución fallida en la lista de las ejecuciones recientes y busca el icono de advertencia rojo. Puedes desplegar la acción afectada; ahí las secciones Entradas y Salidas muestran el código de estado exacto y el mensaje de error original del servicio llamado.

¿Merece la pena solucionar cada error uno mismo de inmediato?

Para errores HTTP puntuales como un 429 o un 502, normalmente basta con reintentarlo, porque la causa está en el servicio externo y es temporal. Sin embargo, si el mismo error se repite una y otra vez, merece la pena establecer un manejo de errores estructurado en el flujo, por ejemplo con directivas de reintento y una acción de reserva definida, en lugar de reiniciarlo manualmente cada vez.

¿Existen estos códigos de error también en los flujos de escritorio?

Los códigos descritos aquí se refieren a los flujos en la nube. Para los flujos de escritorio, que se ejecutan en tu PC, Microsoft mantiene una referencia propia titulada Gestión de errores de flujos de escritorio, ya que allí influyen otras fuentes de error, como los elementos de la interfaz de usuario o las aplicaciones locales.