---
title: "Tester un endpoint de webhook"
method: POST
path: "/webhooks/{id}/test"
tags: ["Webhooks"]
---

# Tester un endpoint de webhook

`POST /webhooks/{id}/test`

## Request

- Base URL: `https://api.swipify.fr/api/v1`
- URL: `https://api.swipify.fr/api/v1/webhooks/{id}/test`
- Auth: API key in header `X-API-Key`

Livre IMMÉDIATEMENT un événement `webhook.test` signé à l'endpoint et renvoie le résultat (code HTTP retourné par votre serveur). Sert à valider connectivité + vérification de signature sans attendre un vrai événement métier. Scope requis : `webhooks:write`.

## Path parameters

- `id` integer, required

## Response `200`

Résultat de la tentative de livraison

- object
  - `eventId` string, uuid
  - `delivered` boolean: true si votre endpoint a répondu 2xx.
  - `responseStatus` integer, nullable: Code HTTP retourné par votre endpoint (null si injoignable).
  - `error` string: Motif si delivered=false (timeout, HTTP 4xx/5xx, URL refusée…).

## Other responses

- `401`: Échec d'authentification : clé API manquante (`missing_api_key`) ou invalide/révoquée/expirée (`invalid_api_key`). Le client doit présenter une clé valide.
- `403`: Clé authentifiée mais non autorisée : scope insuffisant pour cette route (`scope_required`), ou organisation sans abonnement Pro actif (`pro_required`). `GET /me` reste accessible sans Pro pour diagnostiquer la clé.
- `404`: Ressource introuvable
- `429`: Trop de requêtes (quota de la clé API, ou de l'organisation pour les analyses de document, dépassé pour la fenêtre courante)

---

[API](https://skmtc.dev/swipify/apis/swipify-api-publique.md) · [All operations](https://skmtc.dev/swipify/apis/swipify-api-publique/llms.txt) · [OpenAPI document](https://skmtc.dev/swipify/apis/swipify-api-publique/revisions/44c17201b479?raw)