Recevoir les prospects

Le formulaire « Je suis intéressé » de votre site crée un contact directement dans Hussteer, rattaché au bien concerné.

Envoyer un prospect

{
  "firstName": "Camille",
  "lastName": "Mercier",
  "email": "camille.mercier@example.fr",
  "phone": "06 60 90 50 20",
  "message": "Je souhaite visiter ce bien.",
  "propertyId": "11111111-1111-1111-1111-111111111111",
  "consent": true
}

curl -X POST 'https://hussteer.com/api/v1/leads' \
  -H 'Authorization: Bearer hus_at_example' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: form-2026-09-16-a1b2c3' \
  -d '{
    "firstName": "Camille",
    "lastName": "Mercier",
    "email": "camille.mercier@example.fr",
    "phone": "06 60 90 50 20",
    "message": "Je souhaite visiter ce bien.",
    "propertyId": "11111111-1111-1111-1111-111111111111",
    "consent": true
  }'

Ce qui est exigé

• un nom (prénom et/ou nom) ;
• au moins un moyen de rappeler : e-mail OU téléphone. Les deux valent mieux.
• tout le reste est facultatif ; les champs inconnus sont ignorés, pas refusés.

Rattacher au bien

Avec `propertyId`, le prospect apparaît directement sur la fiche du bien, dans les contacts associés. L'agent voit donc « cette personne vient du site et s'intéresse à ce bien » sans avoir à le déduire.

Doublons

Un contact portant la même adresse e-mail dans l'agence est RÉUTILISÉ : la réponse porte alors `contact_reused: true`. Deux personnes qui partagent un numéro de téléphone, en revanche, ne sont jamais fusionnées automatiquement — c'est la règle du module Contacts, et l'API ne s'en écarte pas.

Idempotence

Envoyez un en-tête `Idempotency-Key` propre à chaque soumission de formulaire. Si le réseau vous fait rejouer la requête, Hussteer rend 200 et le même contact, au lieu de créer un doublon. Une vraie création rend 201 : vos journaux distinguent donc les deux sans lire le corps.

Consentement

Le champ `consent` est un booléen. Ne l'envoyez que si votre formulaire pose réellement la question : omettre le champ signifie « non renseigné », ce qui n'est pas la même chose qu'un refus.

Formulaires attaqués

• corps limité à 16 Ko, message à 4 000 caractères ;
• les chevrons et les caractères de contrôle sont neutralisés ;
• 30 écritures par minute et par intégration ;
• prévoyez tout de même un anti-robot sur votre formulaire : l'API protège Hussteer, pas votre page.