Mettre à jour des leads via API | Centre d'aide ReactIn

Vous avez déjà ajouté un lead et devez modifier ses données plus tard — corriger une faute, ajouter une nouvelle variable personnalisée ou pousser un email mis à jour depuis votre CRM ? L'API Update Lead vous permet de modifier un lead existant sur place, sans créer de doublon.

✅ Ce dont vous aurez besoin avant de commencer

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

Votre Organization ID, votre List ID et votre API Key
L'id du lead que vous souhaitez mettre à jour

📘 👉 Vous ne savez pas comment obtenir vos identifiants API ? Suivez ce guide

💡 Vous obtenez l'id d'un lead via l'endpoint Récupérer des leads (le champ id de chaque lead).

🔗 Endpoint de l'API

Envoyez une requête PATCH à cet endpoint pour mettre à jour un lead :

PATCH https://app.reactin.io/api/[organizationId]/lists/[listId]/leads

🔐 Authentification et en-têtes

En-tête	Valeur	Description
Authorization	`YOUR_API_KEY`	Votre API key secrète issue de ReactIn
Content-Type	`application/json`	Requis pour toutes les requêtes

🔒 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)

Le seul champ requis est leadId. Tous les autres champs sont optionnels — n'envoyez que ceux que vous voulez modifier. Il s'agit d'une vraie mise à jour partielle : les champs que vous omettez restent inchangés.

Champ	Requis	Description
`leadId`	Oui	L'`id` du lead à mettre à jour
`email`	Optionnel	Nouvel email
`firstName`	Optionnel	Nouveau prénom
`lastName`	Optionnel	Nouveau nom
`linkedinUrl`	Optionnel	Nouvelle URL de profil LinkedIn
`companyName`	Optionnel	Nouveau nom d'entreprise
`customVariable1–5`	Optionnel	Toute variable personnalisée à ajouter ou remplacer

⚠️ Mettre à jour un lead réinitialise son statut d'enrichissement : ReactIn tentera donc de l'enrichir à nouveau avec les nouvelles données. Cela déclenche aussi le webhook LEAD_UPDATED si vous en avez un connecté.

🧪 Exemple (JavaScript)

await fetch("https://app.reactin.io/api/[organizationId]/lists/[listId]/leads", {
  method: "PATCH",
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    leadId: 'lead_a1b2c3',
    email: 'john.doe@newcompany.com',
    companyName: 'New Company',
    customVariable1: 'Renewed'
  })
});

🧾 Format de réponse

{
  "success": true
}

🚫 Erreurs courantes

Code	Description
400	Bad request – le champ `leadId` est manquant
401	Unauthorized – API key invalide ou manquante
404	Not found – la liste ou le lead n'existe pas dans votre organisation
429	Too many requests – limite de débit dépassée
500	Internal server error – réessayez plus tard

💡 Bonnes pratiques

🔎 Récupérez l'id du lead via l'endpoint Récupérer des leads avant de le mettre à jour
✂️ N'envoyez que les champs que vous souhaitez réellement modifier
🔐 Gardez votre API key privée — utilisez un serveur backend ou un proxy
🔁 Ajoutez une logique de nouvelle tentative pour les erreurs occasionnelles de réseau ou de serveur

💡 Astuce de pro : Comme les mises à jour relancent l'enrichissement, regrouper plusieurs modifications dans un seul PATCH est plus économique que d'envoyer une requête par champ.