Aperçu

L’API de La Growth Machine t’aide à automatiser la création de leads, enrichir tes données, et construire des dashboards ou intégrations adaptés à ton workflow. Que tu envoies des leads depuis Sheets, que tu récupères les stats de tes campagnes ou que tu connectes Zapier, ce guide t’explique tout ce dont tu as besoin y compris les champs obligatoires, les contournements possibles et l’endroit où trouver ta clé API.

Avantages :

Automatiser la création de leads directement depuis Google Sheets ou ton CRM.
Utiliser des endpoints flexibles pour envoyer ou récupérer des données de campagnes ou de leads.
Récupérer des métriques de performance pour suivre les taux d’ouverture, de clics, de réponses et de bounce.
Contourner certaines validations, notamment lorsqu’un email réel n’est pas disponible.
Accéder facilement à ta clé API et l’utiliser en toute sécurité.
Construire du reporting automatisé avec Zapier et Google Sheets.

Utiliser l’API de La Growth Machine

Disponibilité de l’API selon les plans

L’API est disponible à partir du plan Pro.

Plan Basic : Connexion Email + LinkedIn uniquement (pas d’API, pas de Zapier, pas de Clay/Phantombuster).
Plan Pro : Accès API, intégration Zapier, Clay, Phantombuster, webhooks illimités.
Plan Ultimate : Tout le plan Pro + intégrations illimitées.

Comment trouver ta clé API

Tu peux accéder à ta clé API directement depuis ton workspace :

Va dans All settings
Clique sur Integrations & API
Ouvre l’onglet API

Tu y trouveras : ta documentation API, ta clé API, et tes API logs.

Important : Ne partage jamais ta clé API. Regénère-la immédiatement si tu penses qu’elle a été exposée.

Créer des leads via l’API

Endpoint de création de lead

Tu dois utiliser cet endpoint pour créer un lead :

POST https://apiv2.lagrowthmachine.com/flow/leads?apikey=Your-external-apikey

Tu peux aussi passer la clé dans le header :

x-api-key: Your-external-apikey

Champs obligatoires pour créer un lead

Tu dois fournir au moins un des éléments suivants :

audience + proEmail, OU
persoEmail, OU
linkedinUrl, OU
twitter, OU
firstName + lastName + (companyUrl OU companyName)

Voici un exemple :

{
  "firstName": "John",
  "lastName": "Doe",
  "persoEmail": "[email protected]",
  "companyName": "ACME",
  "linkedinUrl": "https://linkedin.com/in/johndoe",
  "tags": ["from-api"]
}

Tu peux voir cette erreur si l'email est manquant ou invalide :

{"error": "ValidationError: \"persoEmail\" must be a valid email"}

Pour des raisons techniques, notre API exige une adresse email valide au moment de la création d’un lead, même si tu ne prévois pas forcément de lui écrire.

Tu peux transmettre une adresse générique, comme :

{
  "firstName": "John",
  "lastName": "Doe",
  "persoEmail": "[email protected]"
}

Ça permet de créer le lead sans problème.
Ensuite, pendant l’enrichissement, LGM récupérera automatiquement l’email professionnel réel si disponible sur LinkedIn.

Automatiser la création de leads depuis Google Sheets

Utiliser Google Apps Script

Ce script :

lit un Google Sheet
transforme chaque ligne en JSON
envoie le tout au endpoint de création de lead
écrit OK ou ERROR sur la ligne correspondante

function createLeadsInLGM() {
  const API_KEY = "YOUR_API_KEY";
  const SHEET_NAME = "Leads";
  const url = "https://apiv2.lagrowthmachine.com/flow/leads?apikey=" + API_KEY;

  const sheet = SpreadsheetApp.getActive().getSheetByName(SHEET_NAME);
  const data = sheet.getDataRange().getValues();
  const headers = data.shift();

  data.forEach((row, index) => {
    const lead = {};

    headers.forEach((header, i) => {
      const value = row[i];
      if (value !== "") {
        lead[header] = value;
      }
    });

    try {
      const response = UrlFetchApp.fetch(url, {
        method: "post",
        contentType: "application/json",
        payload: JSON.stringify(lead),
      });

      const result = JSON.parse(response.getContentText());
      Logger.log("Lead created: " + JSON.stringify(result));
      sheet.getRange(index + 2, headers.length + 1).setValue("OK");

    } catch (err) {
      Logger.log("Error: " + err);
      sheet.getRange(index + 2, headers.length + 1).setValue("ERROR");
    }
  });
}

Version minimale (email + firstname + lastname)

const lead = {
  email: row[0],
  firstname: row[1],
  lastname: row[2]
};

Utiliser l’API de stats de campagne

Endpoint des statistiques

GET https://apiv2.lagrowthmachine.com/flow/campaigns/:campaignId/stats?apikey=YOUR_API_KEY

Cet endpoint retourne des métriques de performance comme :

taux d’ouverture
taux de clic
taux de réponse
taux de bounce
nombre de leads reached
étapes complétées

Automatiser un reporting hebdomadaire via Zapier

Mettre en place le workflow dans Zapier en seulement 4 steps

Choisis ton trigger:

Utilise Zapier Schedule, pour déclencher le zap tous les lundis à 9h, par exemple.

2. Fais la requête API:

Utilise Webhooks by Zapier (GET) :

https://apiv2.lagrowthmachine.com/flow/campaigns/:campaignId/stats?apikey=YOUR_API_KEY

3. Ensuite, formate la réponse:

Extrait les métriques : open, click, reply, bounce etc.

4. Pour terminer, envoies la data vers ton Google Sheets

Ajoute une ligne par semaine et applique une mise en forme conditionnelle :

Vert si reply rate > 8%
Rouge si bounce rate > 10%
Orange si open rate < 40%

Tu obtiens un dashboard live de tes performances, mis à jour chaque semaine, parfait pour comparer tes personas, tester des séquences et présenter des résultats clairs à ta direction.

FAQ

Ai-je besoin d’une adresse email valide pour créer un lead ?

Oui. Pour des raisons techniques, l’API exige un email valide lors de la création. Tu peux utiliser un email factice comme [email protected]

Quels champs sont obligatoires pour créer un lead via l’API ?

Tu dois fournir au moins l’un des éléments suivants : audience + proEmail, persoEmail, linkedinUrl, twitter, ou firstName + lastName + (companyUrl ou companyName).

L’accès API est-il inclus dans tous les plans ?

Non. L’API est disponible à partir du plan Pro.

Puis-je automatiser un reporting avec les stats de campagne ?

Oui ! Tu peux récupérer les stats via l’API et créer un dashboard hebdomadaire avec Zapier + Google Sheets.

Comment puis-je utiliser l’API de La Growth Machine pour automatiser mes workflows ?