Recursos · Integración n8n

Integración GitHub n8nAutomatiza GitHub con n8n.

Cada push, cada incidencia y cada release puede arrancar un flujo de trabajo. La integración GitHub n8n abre 38 operaciones repartidas en 8 recursos, y el GitHub Trigger escucha 42 eventos por webhook. Está pensada para equipos que quieren resolver releases, revisiones y triaje sin vivir entre pestañas.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué cubre la integración GitHub n8n?

La integración GitHub n8n son dos nodos que ya vienen con n8n. El nodo GitHub llama a la API de GitHub para leer y escribir archivos, incidencias, releases y datos de un repositorio. El GitHub Trigger registra un webhook en el repositorio, es decir una URL que GitHub llama con el contenido del evento, y así el flujo arranca en el momento en que allí pasa algo. No hay nada que instalar: los dos nodos están disponibles en n8n Cloud y en una instancia autoalojada.

El triaje de incidencias suele ser lo primero que duele. El evento issues salta cuando se abre una incidencia, cuando cambia de etiqueta, cuando se asigna y cuando se cierra; issue.edit devuelve etiquetas, responsables y un motivo de estado como not_planned. Si con un repaso semanal basta, repository.getIssues filtra por State, Labels y Updated Since, y las filas acaban en Google Sheets, o en Jira si el equipo técnico lleva ahí su trabajo.

Segundo terreno, el repositorio como archivo. file.create hace commit de un archivo a partir de un texto o de un campo binario, con el Commit Message que tú decides: así es como una copia diaria de los flujos de n8n termina versionada en un repositorio, con un commit por ejecución. file.list recorre una carpeta, file.get trae un archivo concreto y file.delete limpia lo que ha caducado.

Tercer terreno, las releases. El tag está listo, el flujo llama a release.create con el campo Tag, la deja en Draft mientras alguien repasa las notas y después la publica con release.update. En la misma ejecución, el cuerpo de la release sale hacia Slack y nadie tiene que abrir el repositorio para enterarse de qué ha salido.

El nodo se queda en 38 operaciones. Todo lo que la API de GitHub ofrece más allá pasa por el nodo HTTP Request, que llama a cualquier endpoint reutilizando el mismo credential de GitHub, o sea la credencial que guardas una sola vez en n8n, como autenticación predefinida. Ningún segundo token que mantener.

Hay dos límites que conviene tener claros antes de montar nada. Las listas van paginadas: si Return All se queda desmarcado, la ejecución para en Limit, y en el caso de las pull requests ese Limit tiene un techo de 100. Las operaciones de tráfico miran una ventana fija: repository.listPopularPaths y repository.listReferrers devuelven 10 entradas de los últimos 14 días, así que una vista trimestral solo existe si cada ejecución se guarda en algún sitio, por ejemplo en Mongodb. ¿Todavía dudas entre plataformas? La Reseña n8n pone los criterios sobre la mesa, y el Curso n8n repasa los nodos uno a uno.

Conexión

¿Cómo se conecta GitHub con n8n?

  1. 01

    Genera un token de acceso personal

    Verifica tu correo en GitHub, abre los Settings de tu perfil, entra en Developer settings y, dentro de Personal access tokens, elige Tokens (classic). Es el tipo que recomienda n8n: los tokens fine-grained se acotan a repositorios y permisos concretos, pero arrastran limitaciones. Pon nombre al token en el campo Note, elige una Expiration y marca los Scopes. Después añade repo.

  2. 02

    Crea el credential en n8n

    En el menú Credentials, añade un credential de GitHub. Deja GitHub server como está, salvo en GitHub Enterprise Server, donde lleva la URL de tu servidor. Rellena User con tu nombre tal como aparece en tu perfil de GitHub y pega el Access Token. Creado una vez, vuelve en el desplegable de cada nodo GitHub.

  3. 03

    Cambia a OAuth2 si lo prefieres

    OAuth2 es el otro método admitido, para el nodo GitHub y el GitHub Trigger. En una instancia autoalojada, registra una OAuth app: Settings, Developer settings, OAuth apps, New OAuth App. Rellena el Application name y la Homepage URL, copia la OAuth Redirect URL de n8n en el Authorization callback URL y lleva el Client ID y el Client Secret a n8n.

Disparadores

¿Qué puede arrancar un flujo desde GitHub ?

Github Trigger es el nodo que arranca un workflow cuando algo ocurre en GitHub. Escucha 42 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que GitHub llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

check_run.*1
  • check_run.
    • check_run
check_suite.*1
  • check_suite.
    • check_suite
commit_comment.*1
  • commit_comment.
    • commit_comment
create.*1
  • create.
    • create
delete.*1
  • delete.
    • delete
deploy_key.*1
  • deploy_key.
    • deploy_key
deployment.*1
  • deployment.
    • deployment
deployment_status.*1
  • deployment_status.
    • deployment_status
fork.*1
  • fork.
    • fork
github_app_authorization.*1
  • github_app_authorization.
    • github_app_authorization
gollum.*1
  • gollum.
    • gollum
installation.*1
  • installation.
    • installation
installation_repositories.*1
  • installation_repositories.
    • installation_repositories
issue_comment.*1
  • issue_comment.
    • issue_comment
issues.*1
  • issues.
    • issues
label.*1
  • label.
    • label
marketplace_purchase.*1
  • marketplace_purchase.
    • marketplace_purchase
member.*1
  • member.
    • member
membership.*1
  • membership.
    • membership
meta.*1
  • meta.
    • meta
milestone.*1
  • milestone.
    • milestone
org_block.*1
  • org_block.
    • org_block
organization.*1
  • organization.
    • organization
page_build.*1
  • page_build.
    • page_build
project.*1
  • project.
    • project
project_card.*1
  • project_card.
    • project_card
project_column.*1
  • project_column.
    • project_column
public.*1
  • public.
    • public
pull_request.*1
  • pull_request.
    • pull_request
pull_request_review.*1
  • pull_request_review.
    • pull_request_review
pull_request_review_comment.*1
  • pull_request_review_comment.
    • pull_request_review_comment
push.*1
  • push.
    • push
release.*1
  • release.
    • release
repository.*1
  • repository.
    • repository
repository_import.*1
  • repository_import.
    • repository_import
repository_vulnerability_alert.*1
  • repository_vulnerability_alert.
    • repository_vulnerability_alert
security_advisory.*1
  • security_advisory.
    • security_advisory
star.*1
  • star.
    • star
status.*1
  • status.
    • status
team.*1
  • team.
    • team
team_add.*1
  • team_add.
    • team_add
watch.*1
  • watch.
    • watch

El trigger también acepta * (cualquier evento). Útil para logs, peligroso en producción.

Notas de configuración

01Set up the GitHub TriggerEl trigger vigila un repositorio y arranca el flujo cuando allí ocurren los eventos que has marcado. Al activar el flujo, n8n registra un webhook en GitHub, o sea una URL que GitHub llama con el contenido del evento, de modo que cada evento llega a n8n en unos segundos. Sin polling, sin intervalo que ajustar y sin nada que programar. El nodo va por la versión 1.

El trigger vigila un repositorio y arranca el flujo cuando allí ocurren los eventos que has marcado. Al activar el flujo, n8n registra un webhook en GitHub, o sea una URL que GitHub llama con el contenido del evento, de modo que cada evento llega a n8n en unos segundos. Sin polling, sin intervalo que ajustar y sin nada que programar. El nodo va por la versión 1.

Parámetros clave

  • Repository Owner: el usuario o la organización dueña del repositorio, elegido en la lista o escrito a mano.
  • Repository Name: el repositorio en sí. Propietario y nombre deciden juntos dónde se crea el webhook.
  • Events: a qué se suscribe el flujo, entre los 42 disponibles. El comodín * los coge todos de golpe, útil mientras inspeccionas el contenido de un evento y pesado ya en producción.
  • Insecure SSL, dentro de Options: indica si GitHub verifica el certificado SSL del host de n8n al entregar los contenidos. Solo importa en una instancia autoalojada.
Cuándo usarlo
siempre que la reacción tenga que ser inmediata y no programada. Un comentario que responder, un despliegue que lanzar, un canal al que avisar.
02Push and Pull Request eventspush es el evento por defecto del trigger: salta con un push a una rama del repositorio, y los push de tags también lo disparan. pull_request es el más hablador de los cuatro. Reacciona cuando una pull request se abre, se edita, se cierra, se reabre, se asigna, se desasigna, se etiqueta, se desetiqueta, se bloquea, se desbloquea, se sincroniza, pasa a ready for review, y cuando se pide una revisión o se retira esa petición. pull_request_review salta cuando una revisión se envía en un estado distinto de pending, cuando se edita su cuerpo y cuando se descarta. pull_request_review_comment cubre los comentarios del diff unificado en la pestaña Files Changed, creados, editados o borrados.

push es el evento por defecto del trigger: salta con un push a una rama del repositorio, y los push de tags también lo disparan. pull_request es el más hablador de los cuatro. Reacciona cuando una pull request se abre, se edita, se cierra, se reabre, se asigna, se desasigna, se etiqueta, se desetiqueta, se bloquea, se desbloquea, se sincroniza, pasa a ready for review, y cuando se pide una revisión o se retira esa petición. pull_request_review salta cuando una revisión se envía en un estado distinto de pending, cuando se edita su cuerpo y cuando se descarta. pull_request_review_comment cubre los comentarios del diff unificado en la pestaña Files Changed, creados, editados o borrados.

Parámetros clave

  • Events: marca los cuatro por separado. Cada uno llega con su propio contenido, así que lo que venga detrás del trigger tiene que saber qué evento ha recibido antes de actuar.
Casos de uso
lanzar una revisión automática en cuanto se abre una pull request y devolver el veredicto al hilo, o avisar al autor cuando su revisión se descarta.
03Issues, Issue Comment, Label and Milestone eventsissues sigue una incidencia de principio a fin: abierta, editada, borrada, transferida, fijada, desfijada, cerrada, reabierta, asignada, desasignada, etiquetada, desetiquetada, bloqueada, desbloqueada, puesta en un hito o sacada de él. issue_comment salta cuando se crea, se edita o se borra un comentario. label avisa de una etiqueta del repositorio creada, editada o borrada, y milestone hace lo mismo con un hito creado, cerrado, abierto, editado o borrado. Juntos mantienen al día cualquier herramienta que viva fuera de GitHub.

issues sigue una incidencia de principio a fin: abierta, editada, borrada, transferida, fijada, desfijada, cerrada, reabierta, asignada, desasignada, etiquetada, desetiquetada, bloqueada, desbloqueada, puesta en un hito o sacada de él. issue_comment salta cuando se crea, se edita o se borra un comentario. label avisa de una etiqueta del repositorio creada, editada o borrada, y milestone hace lo mismo con un hito creado, cerrado, abierto, editado o borrado. Juntos mantienen al día cualquier herramienta que viva fuera de GitHub.

Parámetros clave

  • Events: suscribirse solo a issues ya genera bastante tráfico, porque una sesión de triaje lo dispara con cada etiqueta y cada asignación.
Casos de uso
replicar las incidencias nuevas en la herramienta que soporte abre de verdad, y cerrar la copia cuando la incidencia se cierra con el motivo completed.
04Release, Check Run, Check Suite, Status and Deployment eventsEsta es la familia que escucha una cadena de entrega. release salta cuando una release se publica, se despublica, se crea, se edita, se borra o pasa a preversión. check_run se dispara cuando un check run se crea, se vuelve a pedir, se completa o lleva una acción solicitada, y check_suite cuando una suite se completa, se pide o se vuelve a pedir. status avisa de un cambio de estado en un commit de Git. deployment y deployment_status representan un despliegue y su estado. page_build salta con un push a una rama con GitHub Pages activado, gh-pages para páginas de proyecto y master para las de usuario y organización.

Esta es la familia que escucha una cadena de entrega. release salta cuando una release se publica, se despublica, se crea, se edita, se borra o pasa a preversión. check_run se dispara cuando un check run se crea, se vuelve a pedir, se completa o lleva una acción solicitada, y check_suite cuando una suite se completa, se pide o se vuelve a pedir. status avisa de un cambio de estado en un commit de Git. deployment y deployment_status representan un despliegue y su estado. page_build salta con un push a una rama con GitHub Pages activado, gh-pages para páginas de proyecto y master para las de usuario y organización.

Parámetros clave

  • Events: release y status combinan bien, uno dice qué ha salido y el otro si el commit que hay detrás está en verde.
Casos de uso
anunciar una release publicada con sus notas, o recoger una check suite completada para mover la incidencia que había lanzado la compilación.
05Repository, Member, Team, Star and Security eventsLos eventos de gobierno casi nunca se automatizan, y justo por eso merecen el rato. repository salta cuando un repositorio se crea, se archiva, se desarchiva, se renombra, se edita, se transfiere, se hace público o se hace privado, y los hooks de organización añaden el caso del borrado. member avisa de un colaborador que acepta una invitación, que es retirado o al que le cambian los permisos. star salta cuando se añade o se quita una estrella, watch cuando alguien marca el repositorio con una estrella, fork cuando un usuario lo bifurca y public cuando un repositorio privado pasa a código abierto. En seguridad, repository_vulnerability_alert salta cuando una alerta se crea, se descarta o se resuelve, y security_advisory cuando un aviso se publica, se actualiza o se retira.

Los eventos de gobierno casi nunca se automatizan, y justo por eso merecen el rato. repository salta cuando un repositorio se crea, se archiva, se desarchiva, se renombra, se edita, se transfiere, se hace público o se hace privado, y los hooks de organización añaden el caso del borrado. member avisa de un colaborador que acepta una invitación, que es retirado o al que le cambian los permisos. star salta cuando se añade o se quita una estrella, watch cuando alguien marca el repositorio con una estrella, fork cuando un usuario lo bifurca y public cuando un repositorio privado pasa a código abierto. En seguridad, repository_vulnerability_alert salta cuando una alerta se crea, se descarta o se resuelve, y security_advisory cuando un aviso se publica, se actualiza o se retira.

Parámetros clave

  • Events: cuatro de ellos solo saltan en hooks de organización, membership, org_block, organization y team. Un webhook puesto en un repositorio no los verá nunca.
Casos de uso
dejar rastro escrito de cada cambio de permisos, y mandar los avisos de seguridad a quien tiene que arreglarlo.
Acciones

¿Qué sabe hacer el nodo GitHub ?

El nodo GitHub expone 38 operaciones en 8 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDeleteCreate CommentDisableDispatchDispatch and Wait for CompletionEditEnableGet IssuesGet LicenseGet MembersGet ProfileGet Pull RequestsGet RepositoriesGet UsageGet IssuesInviteListList Popular PathsList ReferrersLock
File✓✓✓✓✓
Issue✓✓✓✓✓
Organization✓✓
Release✓✓✓✓✓
Repository✓✓✓✓✓✓✓
Review✓✓✓✓
User✓✓✓
Workflow✓✓✓✓✓✓✓

File

5 operaciones
01

Create a file

file.create

Lo que ves en n8n

Notas y casos de uso

Hace commit de un archivo nuevo en el repositorio. El contenido sale de un texto que escribes o de un campo binario que ha producido un nodo anterior, así que un PDF generado recorre el mismo camino que una página en Markdown.

Parámetros clave

  • File Path: la ruta completa dentro del repositorio, del tipo docs/README.md, no solo el nombre del archivo.
  • Binary File: es el desvío. Desmarcado, n8n coge File Content; marcado, coge el archivo que está en Input Binary Field.
  • Commit Message: la línea que aparece en el historial del repositorio, así que mejor que diga qué flujo ha escrito.
Casos de uso
dejar cada noche la exportación de los flujos de n8n en un repositorio de copia, con un commit por ejecución.
02

Delete a file

file.delete

Lo que ves en n8n

Notas y casos de uso

Quita un archivo del repositorio y registra la eliminación como un commit más, igual que cualquier otro cambio.

Parámetros clave

  • File Path: la ruta completa del archivo que hay que borrar; cuando viene de un nodo anterior, una expresión como {{ $json.filePath }} evita escribirla a mano.
  • Commit Message: obligatorio aquí también, y la única explicación que guardará el historial.
Casos de uso
limpiar los archivos generados que una release deja obsoletos, como último paso del flujo de publicación.
03

Edit a file

file.edit

Lo que ves en n8n

Notas y casos de uso

Escribe contenido nuevo encima de un archivo que ya existe y hace commit del resultado. Las dos fuentes son las mismas que al crear, texto o binario, con una diferencia que importa: el archivo tiene que estar ahí.

Parámetros clave

  • File Path: señala el archivo que se modifica, con la ruta completa desde la raíz del repositorio, docs/README.md y no README.md.
  • File Content: el texto nuevo, normalmente montado por el nodo anterior.
  • Binary File con Input Binary Field: la otra vía, cuando la versión nueva llega en binario.
  • Commit Message: obligatorio.
Casos de uso
refrescar un changelog o un archivo de estado cada vez que sale una versión.
04

Get a file

file.get

Lo que ves en n8n

Notas y casos de uso

Trae un archivo concreto y se lo pasa al nodo siguiente. Por defecto recibes la respuesta cruda de la API; activa As Binary Property y el archivo llega en binario, listo para adjuntarlo a un correo o subirlo a otro sitio.

Parámetros clave

  • File Path: la ruta completa del archivo que se lee.
  • Put Output File in Field: el nombre del campo binario de salida que llevará el archivo.
  • Reference, en Additional Parameters: un nombre de commit, de rama o de tag. Vacío, GitHub lee la rama por defecto del repositorio, normalmente master.
Casos de uso
sacar un archivo de configuración de una versión etiquetada para compararlo con el que corre en producción.
05

List files

file.list

Lo que ves en n8n

Notas y casos de uso

Enumera lo que contiene una carpeta, un item por entrada. Así es como un flujo recorre un directorio cuyo contenido no puede conocer de antemano.

Parámetros clave

  • File Path: la carpeta que se lee, indicada con la ruta completa desde la raíz del repositorio; el campo lleva la misma etiqueta que en las demás operaciones sobre archivos.
Casos de uso
repasar cada semana una carpeta de documentación y abrir una incidencia por cada página que nadie ha tocado en un mes.

Issue

5 operaciones
06

Create an issue

issue.create

Lo que ves en n8n

Notas y casos de uso

Abre una incidencia nueva en el repositorio y la devuelve, con el número que pedirán todas las operaciones posteriores sobre ella.

Parámetros clave

  • Title: el único campo obligatorio, y la línea que la gente lee en el listado.
  • Body: opcional, y en la práctica donde acaban el mensaje de error, el contenido recibido o el enlace que justifica la incidencia.
  • Assignees: una colección de nombres de usuario. La colección Labels añade un Label y un Assignee ya en la creación.
Casos de uso
convertir un control de monitorización fallido en una incidencia que ya lleva el log y a la persona correcta.
07

Create a comment on an issue

issue.createComment

Lo que ves en n8n

Notas y casos de uso

Publica un comentario debajo de una incidencia existente. No se mueve nada más: conserva su estado, sus etiquetas y sus responsables.

Parámetros clave

  • Issue Number: un número, no un título. Cógelo del paso que creó o leyó la incidencia en lugar de teclearlo.
  • Body: el texto del comentario, muchas veces un resultado que el flujo acaba de calcular.
Casos de uso
dejar los resultados de las pruebas nocturnas bajo la incidencia que sigue el fallo, para que la discusión y las pruebas queden en el mismo sitio.
08

Edit an issue

issue.edit

Lo que ves en n8n

Notas y casos de uso

Actualiza una incidencia que ya está abierta. Todo lo modificable vive en la colección Edit Fields, y solo añades los campos que de verdad quieres tocar.

Parámetros clave

  • Issue Number: la incidencia que se modifica.
  • State: open o closed, junto a State Reason, que acepta completed, not_planned o reopened.
  • Labels, Assignees, Title, Body: el resto de la colección, para reorientar o reescribir.
Casos de uso
cerrar de una tacada las incidencias dormidas con el motivo not_planned después de una sesión de triaje.
09

Get an issue

issue.get

Lo que ves en n8n

Notas y casos de uso

Consulta una incidencia y sus datos, sin tocar nada del repositorio. Es el paso de lectura que se pone delante de una decisión: mirar el estado, mirar las etiquetas y elegir después por dónde sigue el flujo.

Parámetros clave

  • Issue Number: el número de la incidencia que se lee.
Casos de uso
comprobar que una incidencia no se ha cerrado mientras tanto, antes de que un flujo programado vuelva a comentar en ella.
10

Lock an issue

issue.lock

Lo que ves en n8n

Notas y casos de uso

Bloquea la conversación de una incidencia, lo que impide que el hilo siga acumulando comentarios.

Parámetros clave

  • Issue Number: la incidencia que se bloquea.
  • Lock Reason: off-topic, too heated, resolved o spam. El motivo acompaña al bloqueo, así que no hace falta escribir un comentario para explicarlo.
Casos de uso
un repositorio de código abierto que bloquea con resolved cada incidencia cerrada hace más de un mes, para mantener la conversación en lo que está vivo.

Organization

2 operaciones
11

Get repositories for an organization

organization.getRepositories

Lo que ves en n8n

Notas y casos de uso

Una llamada y la organización entera sale en forma de lista: un item por repositorio, así que se puede recorrer en bucle una cuenta que nadie quiere inventariar a mano.

Parámetros clave

  • Return All: marcado, n8n encadena las páginas de la API hasta terminar la organización; desmarcado, para en Limit.
  • Limit: el número máximo de repositorios devueltos mientras Return All siga desmarcado.
Casos de uso
un inventario mensual que escribe todos los repositorios de la organización en una hoja, para sacar a la luz los que ya nadie toca.
12

Get members for an organization

organization.getMembers

Lo que ves en n8n

Notas y casos de uso

Devuelve las personas que pertenecen a una organización, un item por miembro. El mismo interruptor de paginación que en los repositorios, apuntando a una pregunta muy distinta: quién tiene acceso.

Parámetros clave

  • Return All: desmarcado, n8n devuelve hasta Limit miembros y se detiene ahí; marcado, recorre la plantilla completa.
Casos de uso
cruzar cada trimestre la lista de GitHub con la de recursos humanos, y abrir una incidencia por cada cuenta que debería haberse retirado.

Release

5 operaciones
13

Create a release

release.create

Lo que ves en n8n

Notas y casos de uso

Crea una release sobre un tag. Puede salir publicada de inmediato. O quedarse en borrador mientras alguien repasa las notas con calma, que es lo normal cuando hay que redactarlas a mano.

Parámetros clave

  • Tag: el tag de la release, el único campo obligatorio.
  • Name y Body, en Additional Fields: el título de la release y sus notas.
  • Draft la mantiene sin publicar, Prerelease la marca como no lista para producción.
  • Target Commitish: la rama o el SHA del commit desde el que se crea el tag. No se usa si el tag ya existe, y vacío recae en la rama por defecto, normalmente master.
Casos de uso
publicar una versión en cuanto se fusiona el changelog, con las notas leídas de ese archivo.
14

Delete a release

release.delete

Lo que ves en n8n

Notas y casos de uso

Elimina una release identificada por su ID. No hay nada más que rellenar, lo que la convierte también en la operación que conviene revisar dos veces antes de activar el flujo.

Parámetros clave

  • Release ID: el identificador de la release, ni su tag ni su nombre. Sale de un paso de listado como Get Many.
Casos de uso
pasar una vez por semana a limpiar los borradores de release que una cadena de compilación creó y nunca llegó a publicar.
15

Get a release

release.get

Lo que ves en n8n

Notas y casos de uso

Busca una release y devuelve sus datos, sin cambiar nada por el camino. Es el paso que le da al flujo el nombre y las notas de una versión cuando lo único que ha recibido es un identificador.

Parámetros clave

  • Release ID: la release que se lee, entregada por un paso Get Many o por la operación que la creó unos nodos antes.
Casos de uso
recuperar las notas de la versión que se está desplegando para meterlas en el mensaje que reciben los clientes.
16

Get many releases

release.getAll

Lo que ves en n8n

Notas y casos de uso

Recupera las releases de un repositorio. Sirve cuando el flujo necesita el historial y no solo la última versión.

Parámetros clave

  • Return All: marcado, n8n recorre todo el historial de releases; desmarcado, para en Limit.
  • Limit: cuántas releases vuelven cuando Return All está desmarcado.
Casos de uso
reconstruir una página pública de changelog con el cuerpo de cada release cada vez que sale una versión nueva, dejando fuera las preversiones.
17

Update a release

release.update

Lo que ves en n8n

Notas y casos de uso

Modifica una release que ya existe, sean sus notas, su nombre, su tag o su estado.

Parámetros clave

  • Release ID: la release que se actualiza.
  • Draft: puesto en false, la release pasa a publicada. Así termina una publicación en dos tiempos.
  • Body, Name, Tag Name, Prerelease y Target Commitish: el resto de los Additional Fields.
Casos de uso
añadir las notas de migración a una release cuando el despliegue ha salido bien, sin tocar el tag.

Repository

7 operaciones
18

Get a repository

repository.get

Lo que ves en n8n

Notas y casos de uso

Aquí no hay ningún parámetro que rellenar. La operación devuelve los datos que GitHub guarda de un repositorio, lo que la convierte en un primer paso barato: un flujo que va a escribir archivos o a abrir incidencias lee antes el repositorio y se detiene enseguida si la respuesta no es la que esperaba.

Casos de uso
validar un nombre de repositorio que llega de un formulario antes de que el resto del flujo empiece a hacer commits en él.
19

Get issues of a repository

repository.getIssues

Lo que ves en n8n

Notas y casos de uso

Saca las incidencias de un repositorio con los mismos filtros que usarías en el listado de GitHub.

Parámetros clave

  • State: open, closed o all.
  • Labels: varias etiquetas a la vez, separadas por coma.
  • Updated Since: deja solo las incidencias actualizadas a partir de ese momento.
  • Assignee, Creator, Mentioned: acotan por persona.
  • Sort y Direction: created, updated o comments, en orden ascendente o descendente.
  • Return All: desmarcado, la ejecución para en Limit.
Casos de uso
un resumen de los lunes con todo lo etiquetado como bug que se ha movido desde el viernes.
20

Get the license of a repository

repository.getLicense

Lo que ves en n8n

Notas y casos de uso

Si GitHub ha detectado una licencia en el repositorio, esta operación devuelve su contenido. No pide ningún parámetro, así que encaja justo detrás de un paso de listado y responde repositorio a repositorio. Que no haya nada detectado significa que no hay nada que leer, y ese silencio ya es información.

Casos de uso
auditar una organización para localizar los repositorios públicos que salen sin licencia, y abrir una incidencia por repositorio con el hallazgo.
21

Get the profile of a repository

repository.getProfile

Lo que ves en n8n

Notas y casos de uso

Lee el perfil de comunidad de un repositorio: métricas, health score, descripción, licencia y lo demás que GitHub mide ahí. Ningún parámetro que ajustar, de modo que añadirla a un flujo no cuesta prácticamente nada.

Casos de uso
seguir el health score de un repositorio público mes a mes y levantar una alerta cuando baja, en lugar de descubrirlo mucho después.
22

Get pull requests of a repository

repository.getPullRequests

Lo que ves en n8n

Notas y casos de uso

Un flujo de revisión que corre a hora fija en lugar de por evento empieza aquí, con las pull requests de un repositorio traídas como items.

Parámetros clave

  • State: open, closed o all.
  • Sort: created, updated, popularity por número de comentarios, o long-running, que deja solo las pull requests abiertas desde hace más de un mes y con actividad en el último mes.
  • Limit: con techo en 100, el máximo que acepta la API para esta lista.
Casos de uso
un resumen semanal ordenado por long-running que pone nombre a las revisiones que nadie ha retomado.
23

List popular paths in a repository

repository.listPopularPaths

Lo que ves en n8n

Notas y casos de uso

Esta devuelve las 10 rutas de contenido más vistas de un repositorio en los últimos 14 días. Sin filtro y sin rango de fechas: la ventana es fija, así que una vista más larga solo existe si el flujo guarda cada ejecución en algún sitio.

Casos de uso
una foto semanal de los archivos más consultados, guardada en base de datos, para saber qué página de la documentación merece la reescritura.
24

List the top referrers of a repository

repository.listReferrers

Lo que ves en n8n

Notas y casos de uso

Misma ventana fija, otra pregunta: los 10 primeros dominios de referencia de un repositorio en los últimos 14 días, o sea de dónde llegan las visitas. Tampoco pide parámetros, y con la misma consecuencia, el historial te lo guardas tú.

Casos de uso
detectar el día en que un repositorio aparece en un agregador y el tráfico cambia de origen, y contarlo al equipo mientras todavía sirve de algo.

Review

4 operaciones
25

Create a review

review.create

Lo que ves en n8n

Notas y casos de uso

La operación publica una revisión sobre una pull request abierta, con un veredicto que un comentario suelto no lleva.

Parámetros clave

  • PR Number: el número de la pull request que se revisa, escrito a mano o tomado de un nodo anterior con una expresión, {{ $json.campo }}.
  • Event: el veredicto, approve, requestChanges, comment o pending; con pending la revisión queda sin enviar.
  • Body: el texto de la revisión, que GitHub exige cuando el Event es Request Change o Comment.
  • Commit ID, dentro de Additional Fields: el SHA del commit revisado si no es el último.
Casos de uso
un control de traducciones que detecta una cadena sin traducir y pide cambios en el momento, antes de que la pull request llegue a manos de una persona.
26

Get a review

review.get

Lo que ves en n8n

Notas y casos de uso

Vuelve una sola revisión, la del identificador que recibe el nodo, dentro de la pull request indicada.

Parámetros clave

  • PR Number: la pull request que contiene esa revisión.
  • Review ID: el identificador de la revisión que se lee; guarda el que devuelve Create, porque sin él no hay forma de volver a ella.
Casos de uso
una auditoría que recupera la revisión citada en un ticket de soporte para adjuntarla al expediente del cliente.
27

Get many reviews

review.getAll

Lo que ves en n8n

Notas y casos de uso

Salen todas las revisiones de una misma pull request, un item por revisión.

Parámetros clave

  • PR Number: la pull request cuyo historial de revisiones se recorre.
  • Return All: activado, n8n encadena las páginas de la API de GitHub hasta la última revisión; desactivado, se detiene en la cifra de Limit.
  • Limit: cuántas revisiones como máximo se traen mientras Return All siga apagado.
Casos de uso
un informe de calidad que mide cuántas revisiones recibe cada pull request antes de cerrarse.
28

Update a review

review.update

Lo que ves en n8n

Notas y casos de uso

Aquí solo cambia el texto de una revisión ya publicada: el nodo expone Body y nada más.

Parámetros clave

  • PR Number: la pull request afectada.
  • Review ID: la revisión que se reescribe, el mismo identificador que sirve para leerla.
  • Body: el texto nuevo, que sustituye al anterior.
Casos de uso
una revisión a la que se añade el enlace al informe de pruebas cuando por fin está disponible, sin abrir un mensaje nuevo debajo.

User

3 operaciones
29

Get a user's repositories

user.getRepositories

Lo que ves en n8n

Notas y casos de uso

El nodo saca la lista de repositorios del usuario, uno por item. No pide ningún identificador: en pantalla solo está la paginación.

Parámetros clave

  • Return All: activado, el nodo pide página tras página hasta el último repositorio; desactivado, corta antes.
  • Limit: cuántos repositorios se traen mientras Return All esté desactivado.
Casos de uso
una pantalla interna que muestra los repositorios disponibles para que soporte sepa dónde abrir cada ticket.
30

Get a user's issues

user.getUserIssues

Lo que ves en n8n

Notas y casos de uso

Llegan las issues asignadas al usuario, y la colección Filters recorta el montón antes de que estorbe en los nodos siguientes.

Parámetros clave

  • State: open, closed o all.
  • Labels: una o varias etiquetas separadas por comas.
  • Updated Since: una fecha y una hora; solo pasan las issues actualizadas a partir de ese momento.
  • Sort y Direction: orden por created, updated o comments, ascendente o descendente.
  • Mentioned: deja únicamente las issues donde se menciona a una persona concreta.
Casos de uso
un aviso cuando una issue con la etiqueta de incidencia lleva días sin moverse.
31

Invite a user

user.invite

Lo que ves en n8n

Notas y casos de uso

Basta un correo y el nombre de la organización para que la persona reciba su invitación, sin pasar por la página de miembros.

Parámetros clave

  • Organization: la organización de GitHub que recibe a la persona invitada.
  • Email: su dirección de correo, con el formato que el campo muestra como ejemplo, name@email.com.
Casos de uso
un formulario interno donde el responsable escribe el correo del nuevo colaborador y la invitación sale sola, el mismo día de la incorporación.

Workflow

7 operaciones
32

Disable a workflow

workflow.disable

Lo que ves en n8n

Notas y casos de uso

Un workflow del repositorio queda fuera de servicio y sigue así hasta que Enable lo devuelva. Ojo con la palabra: se trata del workflow del repositorio de GitHub, no del flujo n8n que lo rodea.

Parámetros clave

  • Workflow: el que se apaga, elegido en el campo del mismo nombre.
Casos de uso
un repositorio heredado cuyos trabajos programados se apagan mientras dura la migración a la nueva plataforma.
33

Dispatch a workflow event

workflow.dispatch

Lo que ves en n8n

Notas y casos de uso

Una orden de dispatch lanza el trabajo cuando tú lo pides, y n8n devuelve el control enseguida: la ejecución no se queda esperando a que termine.

Parámetros clave

  • Workflow: el que se lanza.
  • Ref: la referencia git que usa la ejecución, un nombre de rama o de etiqueta, para disparar el mismo workflow sobre una rama de pruebas o sobre una versión publicada.
  • Inputs: un objeto JSON con los parámetros de entrada que el workflow espera.
Casos de uso
una batería de pruebas nocturna que arranca desde n8n con el nombre del entorno dentro de Inputs.
34

Dispatch a workflow event and wait for completion

workflow.dispatchAndWait

Lo que ves en n8n

Notas y casos de uso

El arranque es idéntico al de Dispatch, lo que viene después no: la ejecución de n8n se detiene y espera un webhook, es decir una URL que se llama desde fuera, antes de seguir con el nodo siguiente.

Parámetros clave

  • Workflow: el que se dispara.
  • Ref: el nombre de la rama o de la etiqueta sobre la que corre.
  • Inputs: un objeto JSON que lee el trabajo, útil para pasarle un número de versión o un destino.
Casos de uso
la publicación de una web que espera a que termine la compilación antes de avisar al cliente de que ya puede mirarla.
35

Enable a workflow

workflow.enable

Lo que ves en n8n

Notas y casos de uso

Reactivar cuesta una sola llamada: los disparadores propios del workflow vuelven a funcionar desde ese mismo momento, sin tocar nada en el repositorio.

Parámetros clave

  • Workflow: el que se reactiva, seleccionado igual que en Disable.
Casos de uso
la vuelta de un repositorio archivado al catálogo activo, con sus trabajos programados encendidos otra vez en la misma ejecución que actualiza la documentación.
36

Get a workflow

workflow.get

Lo que ves en n8n

Notas y casos de uso

Leer un workflow concreto devuelve un único item, y es la forma más rápida de comprobar que un identificador apunta donde tú crees.

Parámetros clave

  • Workflow: el que se consulta.
Casos de uso
una comprobación previa a un Dispatch, para que un workflow borrado corte la ejecución en el acto y no la haga fallar tres nodos más adelante.
37

Get the usage of a workflow

workflow.getUsage

Lo que ves en n8n

Notas y casos de uso

GitHub devuelve el uso registrado del workflow que indicas en el campo. Es la cifra que conviene mirar cuando un repositorio gasta más rápido de lo previsto.

Parámetros clave

  • Workflow: aquel cuyo uso se consulta.
Casos de uso
un aviso automático cuando el uso de un workflow se dispara respecto al mes anterior, para mirarlo antes de que el consumo siga subiendo.
38

List workflows

workflow.list

Lo que ves en n8n

Notas y casos de uso

No hay nada que rellenar: la operación devuelve los workflows como items, uno por workflow, listos para recorrer en un bucle. Es el punto de partida cuando los identificadores no se conocen de antemano.

Casos de uso
un inventario que recorre los workflows del repositorio y manda cada identificador a Get Usage, en vez de mantener listas a mano dentro del flujo n8n.
Necesitas ayuda

¿Necesitas ayuda para automatizar GitHub con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

GitHub y n8n, las preguntas que vienen después

01¿La integración GitHub n8n es gratuita?
Sí por el lado de n8n. El nodo GitHub y el GitHub Trigger vienen con n8n, así que no hay nada que instalar ni ningún módulo que comprar, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition bajo su licencia Sustainable Use. Un flujo montado en una funciona igual en la otra. Lo que cueste GitHub para tu cuenta es otra pregunta, y esta página no la trata. La única preparación es el credential: un token de acceso personal o una OAuth app, creado una sola vez en el menú Credentials y reutilizado después por todos los flujos que tocan un repositorio.
02¿Qué credenciales y permisos pide el nodo GitHub?
Funcionan dos métodos. El token de acceso a la API sirve con todos los nodos GitHub: generas un personal access token en Developer settings, dentro de Tokens (classic), que es el tipo que recomienda n8n, y luego rellenas el credential con la URL del GitHub server, tu nombre de usuario tal como aparece en tu perfil y el Access Token. Añade el scope repo, porque un token sin ningún scope asignado solo alcanza información pública. OAuth2 es la segunda vía y solo vale para el nodo GitHub y el GitHub Trigger: registras una OAuth app, pegas la OAuth Redirect URL de n8n en el Authorization callback URL y llevas el Client ID y el Client Secret de vuelta a n8n. El GitHub Document Loader no admite OAuth2.
03¿Qué límites tiene el nodo GitHub en n8n?
Cubre 38 operaciones en 8 recursos, lo que deja parte de la API de GitHub fuera del nodo. Lo que falte pasa por el nodo HTTP Request, que alcanza cualquier endpoint reutilizando el mismo credential de GitHub como autenticación predefinida, sin un segundo token que mantener. Dentro del nodo, la paginación es el punto a vigilar: una lista devuelve hasta Limit items mientras Return All siga desmarcado, y la lista de pull requests pone el techo de ese Limit en 100. Las operaciones de tráfico trabajan sobre una ventana fija de 14 días y devuelven 10 entradas, así que un historial más largo solo existe si el flujo guarda cada ejecución. Los tokens fine-grained arrastran además sus propias restricciones, y por eso n8n recomienda los clásicos.
04¿El GitHub Trigger reacciona en tiempo real?
Sí. El GitHub Trigger funciona por webhook: al activar el flujo, n8n registra una URL de webhook en GitHub, y GitHub llama a esa URL con el contenido del evento cada vez que ocurre algo. Los eventos llegan a n8n en unos segundos, sin polling y sin ningún intervalo que configurar. Eliges a qué te suscribes entre los 42 eventos, en el parámetro Events, y el valor comodín los coge todos de golpe. Cuatro eventos solo saltan en hooks de organización, membership, org block, organization y team, de modo que un webhook puesto en un repositorio no los verá nunca. La opción Insecure SSL decide si GitHub verifica el certificado SSL del host de n8n al entregar los contenidos.
05¿n8n o Make para automatizar GitHub?
Depende de dónde quieras que viva la automatización. Make solo está alojado, sin opción de autoalojamiento, y se factura por operación: la factura sigue al volumen y los datos pasan siempre por su plataforma. n8n corre en n8n Cloud o en un servidor que controlas tú, algo que pesa cuando el contenido de los repositorios y los tokens tienen que quedarse dentro de tu infraestructura. Las dos ofrecen una lógica visual, y para un flujo de GitHub que lee archivos y comenta incidencias, las dos hacen el trabajo. Decide por el alojamiento, por el control de los datos y por el modelo de coste antes que por la lista de nodos, porque ahí las dos van parejas.