# Activar webhook de automatización (/es/api/automations/webhook)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 2169 · updated: 2026-09-23 -->
Related: [Activar automatización](/es/api/automations/trigger.md), [Crear mensaje de assistant](/es/api/assistant/create-assistant-message-v2.md)

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](/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](/es/api/automations/trigger).

<div id="use-cases">
  ## Casos de uso [#casos-de-uso]
</div>

* **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.

<div id="get-the-webhook-url-and-auth-header">
  ## Obtén la URL del webhook y el encabezado de autenticación [#obtén-la-url-del-webhook-y-el-encabezado-de-autenticación]
</div>

Abre la página de [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard y haz clic en el botón de ajustes <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> 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 <api-key>`.

Sustituye `<api-key>` 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.

<div id="example">
  ## Ejemplo [#ejemplo]
</div>

Activa una automatización de webhook desde una GitHub Action cada vez que se fusiona código a `main`:

```yaml title=".github/workflows/trigger-docs.yml"
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 }}
```

<div id="rate-limits">
  ## Límites de tasa [#límites-de-tasa]
</div>

Este endpoint comparte un límite de tasa con [Trigger update](/es/api/update/trigger) y [Activar automatización](/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](/es/credits).

`POST /v2/workflow/{projectId}/{workflowSchemaId}/webhook`

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.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "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": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de 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": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de 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": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error."
              }
            }
          }
        }
      }
    },
    "503": {
      "description": "La comprobación de créditos falló. Vuelve a intentar la solicitud.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error."
              }
            }
          }
        }
      }
    }
  }
}
```