Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Creating a GitHub App using URL parameters

You can preselect the settings of a new App GitHub using URL query parameters to quickly set up the new App GitHub's configuration.

En este artículo

About App GitHub URL parameters

You can add query parameters to these URLs to preselect the configuration of a App GitHub on a personal or organization account:

  • User account: https://github.com/settings/apps/new
  • Organization account: https://github.com/organizations/:org/settings/apps/new

The person creating the app can edit the preselected values from the App GitHub registration page, before submitting the app. If you do not include required parameters in the URL query string, like name, the person creating the app will need to input a value before submitting the app.

The following URL creates a new public app called octocat-github-app with a preconfigured description and callback URL. This URL also selects read and write permissions for checks, subscribes to the check_run and check_suite webhook events, and selects the option to request user authorization (OAuth) during installation:

https://github.com/settings/apps/new?name=octocat-github-app&description=An%20Octocat%20App&callback_url=https://example.com&request_oauth_on_install=true&public=true&checks=write&events[]=check_run&events[]=check_suite

The complete list of available query parameters, permissions, and events is listed in the sections below.

App GitHub configuration parameters

NameTypeDescription
namestringThe name of the App GitHub. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action.
descriptionstringA description of the App GitHub.
urlstringThe full URL of your App GitHub's website homepage.
callback_urlstringThe full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests.
request_oauth_on_installbooleanIf your app authorizes users using the OAuth flow, you can set this option to true to allow people to authorize the app when they install it, saving a step. If you select this option, the setup_url becomes unavailable and users will be redirected to your callback_url after installing the app.
setup_urlstringThe full URL to redirect to after someone installs the App GitHub if the app requires additional setup after installation.
setup_on_updatebooleanSet to true to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed.
publicbooleanSet to true when your App GitHub is available to the public or false when it is only accessible to the owner of the app.
webhook_urlstringThe full URL that you would like to send webhook event payloads to.
webhook_secretstringYou can specify a secret to secure your webhooks. See "Securing your webhooks" for more details.
eventsarray of stringsWebhook events. Some webhook events require read or write permissions for a resource before you can select the event when registering a new App GitHub. See the "App GitHub webhook events" section for available events and their required permissions. You can select multiple events in a query string. For example, events[]=public&events[]=label.
domainstringThe URL of a content reference.
single_file_namestringWhen you grant read or write access to the single_file permission, this field provides the path to the single file your App GitHub will manage.

App GitHub permissions

You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select Read & write permissions in the user interface for contents, your query string would include &contents=write. To select Read-only permissions in the user interface for blocking, your query string would include &blocking=read. To select no-access in the user interface for checks, your query string would not include the checks permission.

PermissionDescription
administrationGrants access to various endpoints for organization and repository administration. Can be one of: none, read, or write.
checksGrants access to the Checks API. Can be one of: none, read, or write.
content_referencesGrants access to the "Create a content attachment" endpoint. Can be one of: none, read, or write.
contentsGrants access to various endpoints that allow you to modify repository contents. Can be one of: none, read, or write.
deploymentsGrants access to the Deployments API. Can be one of: none, read, or write.
emailsGrants access to the Emails API. Can be one of: none, read, or write.
followersGrants access to the Followers API. Can be one of: none, read, or write.
gpg_keysGrants access to the GPG Keys API. Can be one of: none, read, or write.
issuesGrants access to the Issues API. Can be one of: none, read, or write.
keysGrants access to the Public Keys API. Can be one of: none, read, or write.
membersGrants access to manage an organization's members. Can be one of: none, read, or write.
organization_hooksGrants access to the Organization Webhooks API. Can be one of: none, read, or write.
organization_planGrants access to get information about an organization's plan using the "Get an organization" endpoint. Can be one of: none or read.
organization_projectsGrants access to the Projects API. Can be one of: none, read, write, or admin.
pagesGrants access to the Pages API. Can be one of: none, read, or write.
planGrants access to get information about a user's GitHub plan using the "Get a user" endpoint. Can be one of: none or read.
pull_requestsGrants access to various pull request endpoints. Can be one of: none, read, or write.
repository_hooksGrants access to the Repository Webhooks API. Can be one of: none, read, or write.
repository_projectsGrants access to the Projects API. Can be one of: none, read, write, or admin.
single_fileGrants access to the Contents API. Can be one of: none, read, or write.
starringGrants access to the Starring API. Can be one of: none, read, or write.
statusesGrants access to the Statuses API. Can be one of: none, read, or write.
team_discussionsGrants access to the Team Discussions API and the Team Discussion Comments API. Can be one of: none, read, or write.
vulnerability_alertsGrants access to receive security alerts for vulnerable dependencies in a repository. See "About security alerts for vulnerable dependencies" to learn more. Can be one of: none or read.
watchingGrants access to list and change repositories a user is subscribed to. Can be one of: none, read, or write.

App GitHub webhook events

Webhook event nameRequired permissionDescription
check_runchecksHa ocurrido una actividad de ejecución de verificación. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "ejecuciones de verificación".
check_suitechecksHa ocurrido una actividad de suite de verificaciones. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "suites de verificaciones".
commit_commentcontentsSe creó un comentario de una confirmación. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "comentario de confirmación".
content_referencecontent_referencesUna referencia de contenido nueva se muestra como created. Se crea una referenci de contenido nueva cuando el cuerpo o el comentario de un informe de problemas o solicitud de extracción incluye un URL que empte con un dominio de referencia de contenido configurado. Para obtener más información, consulta la sección "Utilizar adjuntos de contenido" para aprender más sobre las referencias de contenido y sus adjuntos.
createcontentsSe crea una rama o etiqueta de Git. Para obtener más información, consulta la API de REST de "Datos de Git".
deletecontentsSe borra una rama o etiqueta de Git. Para obtener más información, consulta la API de REST de "Datos de Git".
deploymentdeploymentsSe crea un despliegue. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "despliegue".
deployment_statusdeploymentsSe crea un despliegue. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "estados de despliegue".
forkcontentsUn usuario bifurca un repositorio. Para obtener más información, consulta la API de REST de "bifurcaciones".
gollumcontentsSe crea o actualiza una página de wiki. Para obtener más información, consulta la sección "Acerca de las wikis".
issuesissuesLa actividar relacionada con un informe de problemas. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "informe de problemas".
issue_commentissuesLa actividad relacionada con el comentario de un informe de problemas. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "comentrios del informe de problemas".
labelmetadataLa actividar relacionada con un informe de problemas. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "etiquetas".
membermembersLa actividad relacionada con los colaboradores del repositorio. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "colaboradores".
membershipmembersLa actividad relacionada con la membrecía del equipo. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "miembros del equipo".
milestonepull_requestLa actividar relacionada con los hitos. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "hitos".
organizationmembersLa actividad relacionada con una organización y sus miembros. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "organizaciones".
page_buildpagesRepresenta un intento de creación de un sitio de GitHub Pages, ya sea que fuese exitoso o no. Una carga a una rama habilitada de GitHub Pages (gh-pages para páginas de proyecto, master para páginas de organización y de usuario) activa este evento.
projectrepository_projects or organization_projectsLa actividad relacionada con los tableros de proyecto. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "proyectos".
project_cardrepository_projects or organization_projectsLa actividad relacionada con las tarjetas de proyecto. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "tarjetas de proyecto".
project_columnrepository_projects or organization_projectsLa actividad relacionada con las columnas en un tablero de proyecto. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "columnas de proyecto".
publicmetadataCuando un repositorio privado se hace público. Sin duda alguna: el mejor evento de GitHub Enterprise.
pull_requestpull_requestsLa actividad relacionada con las solicitudes de extracción. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "solicitudes de extracción".
pull_request_reviewpull_requestLa actividad relacionada con las revisiones de la solicitudes de extracción. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "revisiones de la solicitud de extracción".
pull_request_review_commentpull_requestLa actividar relacionada con los comentarios de revisión de la solicitud de extracción en el diff unificado de la misma. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "comentrios de revisión de la solicitud de extracción".
pushcontentsSe cargó una o más confirmaciones a la rama o etiqueta de un repositorio.
releasecontentsLa actividad relacionada con un lanzamiento. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "lanzamientos".
repositorymetadataLa actividad relacionada con un repositorio. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "repositorios".
statusstatusesCuando el estado de una confirmación de Git cambia. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "estados".
teammembersLa actividad relacionada con el equipo de una organización. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "equipos".
team_addmembersCuando se agrega un repositorio a un equipo.
watchmetadataCuando alguien marca un repositorio con una estrella. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "marcar con una estrella".

¿Te ayudó este documento?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.