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.