> ## Documentation Index > Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Activar webhook de automatización > Pone en cola una ejecución de una automatización personalizada con un activador de webhook, en lugar de esperar al evento configurado del activador. Útil para ejecutar automatizaciones desde pipelines de CI/CD, scripts de publicación o cualquier otro sistema que ya emita eventos. Solo se pueden activar automatizaciones personalizadas con un activador de webhook; los demás activadores devuelven una respuesta `404`. Autentícate con una clave de API de organización con acceso de escritura. Usa este endpoint para ejecutar una automatización personalizada configurada con un activador de **Webhook**. Cada solicitud pone en cola una ejecución que usa el prompt guardado de la automatización y lee el historial completo del repositorio. Los cuerpos de solicitud se ignoran. Este endpoint solo admite [automatizaciones personalizadas](/docs/es/automations/create) con un activador de webhook. Las automatizaciones predefinidas y las automatizaciones con cualquier otro activador devuelven una respuesta `404`. Para activar bajo demanda una automatización personalizada programada, usa [Activar automatización](/docs/es/api/automations/trigger).
## Casos de uso
* **Pipelines CI/CD**: Ejecuta una automatización personalizada en cada fusión a `main` o después de una publicación, sin esperar a una ejecución programada. * **Eventos de publicación**: Ejecuta una automatización personalizada desde un script de publicación cuando creas una etiqueta o publicas una nueva versión de un SDK. * **Herramientas internas**: Activa automatizaciones desde dashboards internos, comandos de Slack o tareas programadas que ya ejecutas.
## Obtén la URL del webhook y el encabezado de autenticación
Abre la página de [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard y haz clic en el botón de ajustes de una automatización personalizada con un activador de webhook. La tarjeta del activador muestra la URL completa del webhook y una acción **Copy auth header** para la plantilla del encabezado `Authorization: Bearer `. Sustituye `` por una clave de API de organización sin caducar con acceso de escritura. Crea o gestiona claves en la página [API keys](https://app.mintlify.com/settings/organization/api-keys). Las automatizaciones no crean, almacenan ni rotan claves por ti.
## Ejemplo
Activa una automatización de webhook desde una GitHub Action cada vez que se fusiona código a `main`: ```yaml .github/workflows/trigger-docs.yml theme={null} on: push: branches: [main] jobs: trigger: runs-on: ubuntu-latest steps: - run: | curl -fsS -X POST \ "https://api.mintlify.com/v2/workflow/$PROJECT_ID/$WORKFLOW_ID/webhook" \ -H "Authorization: Bearer ${{ secrets.MINTLIFY_API_KEY }}" env: PROJECT_ID: ${{ vars.MINTLIFY_PROJECT_ID }} WORKFLOW_ID: ${{ vars.MINTLIFY_WORKFLOW_ID }} ```
## Límites de tasa
Este endpoint comparte un límite de tasa con [Trigger update](/docs/es/api/update/trigger) y [Activar automatización](/docs/es/api/automations/trigger): hasta 10 solicitudes cada 10 segundos por organización. Cada ejecución en cola consume créditos al mismo ritmo que cualquier otra ejecución de una automatización personalizada. Consulta [Precios de créditos](/docs/es/credits). ## OpenAPI ````yaml es/admin-openapi.json POST /v2/workflow/{projectId}/{workflowSchemaId}/webhook openapi: 3.0.1 info: title: Mintlify Admin API description: >- Una API de operaciones administrativas, incluidas las actualizaciones de documentación y la gestión de agentes. version: 2.0.0 servers: - url: https://api.mintlify.com security: - bearerAuth: [] paths: /v2/workflow/{projectId}/{workflowSchemaId}/webhook: post: summary: Activar webhook de automatización description: >- Pone en cola una ejecución de una automatización personalizada con un activador de webhook, en lugar de esperar al evento configurado del activador. Útil para ejecutar automatizaciones desde pipelines de CI/CD, scripts de publicación o cualquier otro sistema que ya emita eventos. Solo se pueden activar automatizaciones personalizadas con un activador de webhook; los demás activadores devuelven una respuesta `404`. Autentícate con una clave de API de organización con acceso de escritura. parameters: - name: projectId in: path required: true schema: type: string description: >- El ID de tu proyecto. Cópialo desde la página [API keys](https://app.mintlify.com/settings/organization/api-keys) de tu dashboard. - name: workflowSchemaId in: path required: true schema: type: string description: >- El ID de la automatización que se va a activar. Cópialo desde el panel de ajustes de la automatización en la página [Automatizaciones](https://app.mintlify.com/products/automations) de tu dashboard. responses: '202': description: Ejecución de automatización puesta en cola correctamente. content: application/json: schema: type: object properties: success: type: boolean runId: type: string description: >- El ID de la ejecución de automatización en cola. Aparece en el historial de ejecuciones de la página [Automatizaciones](https://app.mintlify.com/products/automations). '400': description: El ID de la automatización tiene un formato no válido. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: >- Los créditos de IA se han agotado para este ciclo de facturación. Mejora tu plan o espera a que se renueven tus créditos. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- No se encontró la automatización, no está activa, no pertenece a este proyecto o no está configurada con un activador de webhook. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: La comprobación de créditos falló. Vuelve a intentar la solicitud. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Error: type: object properties: error: type: string description: Mensaje de error. securitySchemes: bearerAuth: type: http scheme: bearer description: >- El encabezado Authorization requiere un token de tipo Bearer. Usa una clave de API de administrador. Esta es una clave secreta del lado del servidor. Genera una en la [página de claves de API](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard. ```` ## Related topics - [Vista general de automatizaciones](/docs/es/automations/index.md) - [Gestionar automatizaciones](/docs/es/automations/manage.md) - [GitLab](/docs/es/deploy/gitlab.md)