Webhook de création de destinataires

1. Obtenir l'adresse du webhook

1. Connectez-vous à JalonMail et ouvrez Profil › Webhook de création de destinataires.
2. Choisissez la phase par défaut des destinataires créés et leur état (actif ou à activer manuellement), puis cliquez sur « Créer le webhook ».
3. Copiez l'adresse affichée. Elle contient votre jeton secret : https://jalonmail.com/webhooks/recipients/VOTRE_JETON

Vous pouvez à tout moment désactiver le webhook, ou générer une nouvelle adresse : l'ancienne cesse alors immédiatement de fonctionner.

2. Format de l'appel

• Méthode POST, en JSON (Content-Type: application/json) ou en formulaire classique (application/x-www-form-urlencoded).
• Le jeton est passé dans l'adresse (https://jalonmail.com/webhooks/recipients/VOTRE_JETON) ou dans l'en-tête Authorization: Bearer VOTRE_JETON sur https://jalonmail.com/webhooks/recipients.
• Ajoutez l'en-tête Accept: application/json pour recevoir les erreurs au format JSON.
• Un appel crée un destinataire. Les champs vides sont ignorés : les valeurs par défaut s'appliquent.

3. Champs acceptés

Les destinataires créés reçoivent l'état (actif ou inactif) choisi dans les réglages du webhook. Les autres champs envoyés sont ignorés.

4. Consentement et usage (RGPD)

Transmettez la preuve du consentement recueilli : son origine, sa date et son heure, l'adresse IP et toute précision utile. Un destinataire dont l'origine et la date sont renseignées est considéré comme ayant un consentement renseigné.

Valeurs de consent_source

Le libellé complet est aussi accepté (ex. « LinkedIn »), ainsi que tel, téléphone, site, formulaire et mail.

Usages de l'email (purpose)

Chaque compte dispose des usages « Prospection commerciale », « Informations commerciales complémentaires », « Suivi de la relation client », « Lettre d'information » et peut ajouter les siens depuis Destinataires › Usages de l'email. Envoyez le nom exact de l'usage.

5. Destinataire déjà existant

Si un destinataire de votre compte a déjà cet email :

• son nom, sa langue, sa phase et son état ne sont pas modifiés : vous pouvez renvoyer le même appel sans risque ;
• sa preuve de consentement (consent_*) et son usage (purpose) sont mis à jour s'ils sont fournis. Seuls email et ces champs sont alors nécessaires.

{
  "email": "marie@example.org",
  "consent_source": "web",
  "consent_at": "2026-11-10 14:30:00",
  "consent_ip": "203.0.113.42",
  "purpose": "Prospection commerciale"
}

6. Réponses

Exemple de réponse (201)

{
  "created": true,
  "updated": false,
  "recipient": {
    "id": 1234,
    "email": "marie@example.org",
    "first_name": "Marie",
    "last_name": "Curie",
    "locale": "fr",
    "campaign_started_at": "2026-11-10",
    "phase": "Prospect",
    "is_active": true,
    "unsubscribed": false,
    "consent_source": "web",
    "consent_at": "2026-11-10T14:30:00+01:00",
    "consent_ip": "203.0.113.42",
    "consent_proof": "Case cochée sur https://exemple.fr/contact",
    "purpose": "Prospection commerciale"
  }
}

Exemple d'erreur (422)

{
  "message": "Données invalides.",
  "errors": {
    "phase": ["Cette phase n'existe pas. Phases disponibles : Prospect, Client."]
  }
}

7. Exemples

cURL

curl -X POST https://jalonmail.com/webhooks/recipients/VOTRE_JETON \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email": "marie@example.org",
    "first_name": "Marie",
    "last_name": "Curie",
    "locale": "fr",
    "phase": "Prospect",
    "consent_source": "web",
    "consent_at": "2026-11-10 14:30:00",
    "consent_ip": "203.0.113.42",
    "consent_proof": "Case cochée sur https://exemple.fr/contact",
    "purpose": "Prospection commerciale"
  }'

PHP (formulaire de contact)

$response = file_get_contents('https://jalonmail.com/webhooks/recipients/VOTRE_JETON', false, stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => "Content-Type: application/json\r\nAccept: application/json\r\n",
        'content' => json_encode([
            'email' => $_POST['email'],
            'first_name' => $_POST['first_name'],
            'last_name' => $_POST['last_name'],
            'consent_source' => 'web',
            'consent_at' => date('Y-m-d H:i:s'),
            'consent_ip' => $_SERVER['REMOTE_ADDR'],
            'consent_proof' => 'Case « J\'accepte de recevoir des informations » cochée',
            'purpose' => 'Prospection commerciale',
        ]),
        'ignore_errors' => true,
    ],
]));

JavaScript (Node.js, côté serveur)

const response = await fetch('https://jalonmail.com/webhooks/recipients', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.JALONMAIL_WEBHOOK_TOKEN}`,
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({
    email: 'marie@example.org',
    first_name: 'Marie',
    last_name: 'Curie',
    phase: 'Prospect',
  }),
});
const data = await response.json();

Les outils d'automatisation (Zapier, Make, n8n…) utilisent la même requête : action « Webhook / HTTP », méthode POST, corps JSON.

8. Sécurité et limites

• Le jeton donne le droit d'ajouter des destinataires à votre compte : appelez le webhook depuis votre serveur, jamais depuis le navigateur de vos visiteurs, et ne le publiez pas.
• En cas de fuite, générez une nouvelle adresse depuis votre profil : l'ancienne est aussitôt refusée (404).
• Le webhook n'accède qu'aux données de votre compte (phases, usages, destinataires).
• Limite : 60 appels par minute. Au-delà, la réponse est 429.
• Un destinataire qui s'est désinscrit reste désinscrit : le webhook ne le réactive pas.