# Déclencher un webhook d'automatisation (/fr/api/automations/webhook)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 2230 · updated: 2026-09-23 -->
Related: [Déclencher une automatisation](/fr/api/automations/trigger.md), [Créer un message de l'Assistant](/fr/api/assistant/create-assistant-message-v2.md)

Utilisez cet endpoint pour exécuter une automatisation personnalisée configurée avec un déclencheur **Webhook**. Chaque requête met en file d'attente une exécution qui utilise le prompt enregistré de l'automatisation et lit l'historique complet du dépôt. Les corps de requête sont ignorés.

Cet endpoint ne prend en charge que les [automatisations personnalisées](/fr/automations/create) avec un déclencheur webhook. Les automatisations prédéfinies et les automatisations avec tout autre déclencheur renvoient une réponse `404`. Pour déclencher à la demande une automatisation personnalisée planifiée, utilisez [Déclencher une automatisation](/fr/api/automations/trigger).

<div id="use-cases">
  ## Cas d'utilisation [#cas-dutilisation]
</div>

* **Pipelines CI/CD** : Exécutez une automatisation personnalisée à chaque fusion dans `main` ou après une publication, sans attendre une exécution planifiée.
* **Événements de publication** : Exécutez une automatisation personnalisée depuis un script de publication lorsque vous créez un tag ou publiez une nouvelle version de SDK.
* **Outillage interne** : Déclenchez des automatisations depuis des dashboards internes, des commandes Slack ou des tâches planifiées que vous exécutez déjà.

<div id="get-the-webhook-url-and-auth-header">
  ## Récupérer l'URL du webhook et l'en-tête d'authentification [#récupérer-lurl-du-webhook-et-len-tête-dauthentification]
</div>

Ouvrez la page [Automatisations](https://app.mintlify.com/products/automations) dans votre dashboard et cliquez sur le bouton de paramètres <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>" /> d'une automatisation personnalisée avec un déclencheur webhook. La carte du déclencheur affiche l'URL complète du webhook et une action **Copy auth header** pour le modèle d'en-tête `Authorization: Bearer <api-key>`.

Remplacez `<api-key>` par une clé d'API d'organisation non expirée avec accès en écriture. Créez ou gérez les clés sur la page [API keys](https://app.mintlify.com/settings/organization/api-keys). Les automatisations ne créent, ne stockent ni ne font tourner de clés à votre place.

<div id="example">
  ## Exemple [#exemple]
</div>

Déclenchez une automatisation webhook depuis une GitHub Action chaque fois que du code est fusionné dans `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">
  ## Limites de débit [#limites-de-débit]
</div>

Cet endpoint partage une limite de débit avec [Trigger update](/fr/api/update/trigger) et [Déclencher une automatisation](/fr/api/automations/trigger) : jusqu'à 10 requêtes par tranche de 10 secondes et par organisation. Chaque exécution mise en file d'attente consomme des crédits au même rythme que n'importe quelle autre exécution d'automatisation personnalisée. Consultez [Tarification des crédits](/fr/credits).

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

Met en file d'attente une exécution d'automatisation personnalisée disposant d'un déclencheur webhook, au lieu d'attendre l'événement configuré du déclencheur. Utile pour exécuter des automatisations depuis des pipelines CI/CD, des scripts de publication ou tout autre système qui émet déjà des événements. Seules les automatisations personnalisées avec un déclencheur webhook peuvent être déclenchées ; les autres déclencheurs renvoient une réponse `404`.

Authentifiez-vous avec une clé d'API d'organisation disposant d'un accès en écriture.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "projectId",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "L'identifiant de votre projet. Copiez-le depuis la page [API keys](https://app.mintlify.com/settings/organization/api-keys) de votre dashboard."
    },
    {
      "name": "workflowSchemaId",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "L'identifiant de l'automatisation à déclencher. Copiez-le depuis le panneau de paramètres de l'automatisation sur la page [Automatisations](https://app.mintlify.com/products/automations) de votre dashboard."
    }
  ],
  "responses": {
    "202": {
      "description": "Exécution d'automatisation mise en file d'attente avec succès.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "runId": {
                "type": "string",
                "description": "L'identifiant de l'exécution d'automatisation mise en file d'attente. Il apparaît dans l'historique des exécutions sur la page [Automatisations](https://app.mintlify.com/products/automations)."
              }
            }
          }
        }
      }
    },
    "400": {
      "description": "L'identifiant de l'automatisation est mal formé.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    },
    "402": {
      "description": "Les crédits IA sont épuisés pour ce cycle de facturation. Passez à un plan supérieur ou attendez le renouvellement de vos crédits.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "L'automatisation est introuvable, n'est pas active, n'appartient pas à ce projet ou n'est pas configurée avec un déclencheur webhook.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    },
    "503": {
      "description": "La vérification des crédits a échoué. Réessayez la requête.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    }
  }
}
```