Ajouter des leads via API

✅ Ce dont vous aurez besoin avant de commencer

Avant de pouvoir utiliser cette API, assurez-vous d'avoir :

1. Une SmartList API ReactIn

2. Votre Organization ID, votre List ID et votre API Key

📘 Vous ne savez pas où les trouver ?
👉 Consultez d'abord ce guide pour obtenir vos identifiants API

---

🔗 Endpoint de l'API

Envoyez une requête POST à cet endpoint pour ajouter un lead :

POST https://app.reactin.io/api/[organizationId]/webhooks/reactin/[listId]

ReactIn achemine automatiquement le lead vers la SmartList que vous avez sélectionnée.

---

🔐 Authentification et en-têtes

Vous devez ajouter les en-têtes suivants à votre requête :

🔒 Gardez votre clé API privée et utilisez-la uniquement depuis un code backend sécurisé, jamais depuis le navigateur.

---

🧾 Ce qu'il faut inclure dans votre requête (Body)

Vous devez envoyer les données de votre lead au format JSON.
Vous devez fournir au moins l'un de ces deux éléments :

• Un email

• Une linkedinUrl

Voici ce que vous pouvez envoyer :

💡 Pour activer l'enrichissement automatique, veillez à inclure :

• email

• firstName

• lastName

  OU

• linkedinUrl

  Lorsque les 3 sont présents, ReactIn tente automatiquement de trouver les données manquantes comme les liens de profil, les postes, etc.

---

🧪 Exemple (JavaScript)

await fetch("https://app.reactin.io/api/[organizationId]/webhooks/reactin/[listId]", {
  method: "POST",
  headers: {
    'Content-Type': 'application/json',
    'authorization': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    email: 'john.doe@example.com',
    firstName: 'John',
    lastName: 'Doe',
    linkedinUrl: 'https://www.linkedin.com/in/johndoe/',
    companyName: 'Example Corp',
    customVariable1: 'Offer A',
    customVariable2: 'Campaign 3'
  })
});

✏️ Vous pouvez copier ce code et le tester directement depuis Postman, Insomnia ou un script backend.

---

✅ Si tout fonctionne

Vous recevrez une réponse 200 OK, ce qui signifie que le lead a bien été ajouté à votre SmartList.

---

🚫 Si quelque chose ne va pas

---

💡 Bonnes pratiques

• 🔐 Gardez votre clé API sécurisée et utilisez-la uniquement depuis un backend

• ✅ Validez les données du lead avant de les envoyer

• ⏳ Ajoutez une logique de réessai pour les erreurs temporaires

• 📊 Ne spammez pas : évitez d'envoyer des centaines de leads en une seule fois

---

💡 Astuce de pro : Validez toujours les données avant de les envoyer via l'API afin de réduire les erreurs et d'améliorer la qualité de l'enrichissement.

Prêt à passer à la suite ?
👉 Étape suivante : Récupérer des leads depuis ReactIn via API →