---
title: "Abonne une adresse https aux prospects et/ou aux ventes d'un espace, ou de tout le compte si `space` est omis. Renvoie `secret` UNE seule fois : chaque envoi porte l'en-tête `X-Subtraq-Signature` (`t=HORODATAGE,v1=SIGNATURE`, HMAC-SHA256 de « HORODATAGE.CORPS » avec ce secret). Adresses locales ou privées refusées ; 20 abonnements par compte au plus (`webhook_limit_reached`)."
method: POST
path: "/api/v1/webhooks"
tags: ["webhooks"]
---

# Abonne une adresse https aux prospects et/ou aux ventes d'un espace, ou de tout le compte si \`space\` est omis. Renvoie \`secret\` UNE seule fois : chaque envoi porte l'en-tête \`X-Subtraq-Signature\` (\`t=HORODATAGE,v1=SIGNATURE\`, HMAC-SHA256 de « HORODATAGE.CORPS » avec ce secret). Adresses locales ou privées refusées ; 20 abonnements par compte au plus (\`webhook_limit_reached\`).

`POST /api/v1/webhooks`

## Request

- Base URL: `https://subtraq.co`
- URL: `https://subtraq.co/api/v1/webhooks`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, required: Adresse https, joignable depuis internet, qui recevra les envois.
  - `events` string[], required: Natures d'événement : `lead` (un prospect), `sale` (une vente), ou les deux.
  - `space` string: Raccourci de l'espace écouté. Omis = tous les espaces du compte, présents et à venir.

## Response `200`

Succès.

## Other responses

- `201`: Créé.
- `400`: Paramètres invalides.
- `401`: Clé absente ou révoquée.
- `402`: Quota de la formule atteint.
- `403`: La clé n'a pas le droit demandé.
- `404`: Introuvable dans ce compte.
- `409`: Conflit — un raccourci déjà pris, par exemple.

---

[API](https://skmtc.dev/subtraq/apis/subtraq-api.md) · [All operations](https://skmtc.dev/subtraq/apis/subtraq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subtraq/apis/subtraq-api/revisions/1a3dacdd7d28?raw)