> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Envoyer un événement de test

> Mettez en file un événement webhook.test pour un endpoint de webhook d’intégration, même désactivé, afin de vérifier votre récepteur et la signature.

Met en file un événement `webhook.test` pour cet endpoint uniquement, même s’il est désactivé. Utilisez-le pour vérifier que votre récepteur est joignable et que votre [vérification de signature](https://docs.qwairy.co/fr/developers/integration-webhooks/verify-signatures.md) réussit. Lisez le résultat avec [Lister les envois](https://docs.qwairy.co/fr/developers/endpoints/webhooks/deliveries.md).

Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Modifier un endpoint exige aussi un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez [Webhooks d’intégration](https://docs.qwairy.co/fr/developers/integration-webhooks/overview.md) et [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md).

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**Idempotency-Key** `string` *required*

Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.

**webhookId** `string` *required*

Identifiant de l’endpoint.

## Réponse

Renvoie `202` avec l’envoi mis en file.

**id** `string`

Identifiant de l’envoi, stable entre les tentatives. Il est aussi envoyé dans l’en-tête `X-Qwairy-Delivery`

**eventId** `string`

Identifiant de l’événement, l’`id` de la charge utile. Les renvois le conservent

**event** `string`

[Type d’événement](https://docs.qwairy.co/fr/developers/integration-webhooks/events.md)

**status** `string`

`PENDING`, `DELIVERING`, `SUCCEEDED`, `RETRYING`, `EXHAUSTED` ou `CANCELLED`

**attempts** `integer`

Tentatives effectuées jusqu’ici, de 0 à 8

**nextAttemptAt** `string | null`

Date de la prochaine tentative au format ISO 8601

**lastAttemptAt** `string | null`

Date de la dernière tentative au format ISO 8601

**lastStatusCode** `integer | null`

Statut HTTP renvoyé par votre endpoint lors de la dernière tentative

**lastError** `string | null`

`TIMEOUT`, `CONNECTION`, `HTTP_STATUS` ou `BLOCKED_TARGET` pour la dernière tentative échouée

**deliveredAt** `string | null`

Date de la tentative réussie au format ISO 8601

**createdAt** `string`

Date de création au format ISO 8601

## Requête et réponse synthétiques

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID/test" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: webhook-test-001"
```

```json theme={null}
{
  "id": "ffffffff-0000-4000-8000-000000000000",
  "eventId": "evt_3f2a9c1e-5b7d-4e08-8a41-0c9d6e2b7f10",
  "event": "webhook.test",
  "status": "PENDING",
  "attempts": 0,
  "nextAttemptAt": "2026-10-12T09:00:00.000Z",
  "lastAttemptAt": null,
  "lastStatusCode": null,
  "lastError": null,
  "deliveredAt": null,
  "createdAt": "2026-10-12T09:00:00.000Z"
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `404` | `RESOURCE_NOT_FOUND` | L’endpoint est absent ou appartient à une autre équipe |
| `409` | `IDEMPOTENCY_CONFLICT` | La clé a été réutilisée avec une requête différente |

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie `403 API_KEY_READ_ONLY`. Sur `429`, respectez `Retry-After`. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie `503 SERVICE_UNAVAILABLE` et rien ne change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.