Aller au contenu principal

webhook_subscription_limit_reached

Statut HTTP : 422 · Rejouable : oui, après libération d'un emplacement.

Cause​

Chaque environnement est limité à 20 subscriptions webhook actives. La création et la réactivation (PATCH avec "active": true) sont refusées tant qu'une subscription existante n'est pas supprimée ou désactivée.

La limite compte les subscriptions actives : une subscription désactivée ne consomme pas d'emplacement.

Réponse​

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/webhook_subscription_limit_reached",
  "title": "Webhook Subscription Limit Reached",
  "status": 422,
  "detail": "Maximum of 20 active webhook subscriptions per environment reached. Delete or deactivate one first.",
  "code": "webhook_subscription_limit_reached",
  "instance": "/partner/v1/webhooks/subscriptions",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Extensions​

Aucune — seuls les champs standard ci-dessus.

Que faire​

  • Inventorier les subscriptions actives et repérer les obsolètes :

    curl -s https://api.pesia.fr/partner/v1/webhooks/subscriptions \
      -H "Authorization: Bearer $TOKEN" \
    | jq -r '.data.items[] | select(.active) | "\(.id) \(.endpointUrl)"'

  • Supprimer (voir Supprimer un abonnement) ou désactiver une subscription devenue inutile, puis rejouer la création ou la réactivation.

  • Regrouper plutôt que multiplier : une subscription peut écouter plusieurs types d'événements vers un même endpoint. Vingt emplacements suffisent largement si chaque endpoint n'est enregistré qu'une fois.

Voir aussi : Webhooks · Tous les codes d'erreur