Envoyer les contacts du CRM
Dépose les contacts du CRM, sous la forme du tableau de leur export.
Une date de création au moins, puis la date d'entrée de chaque contact dans chaque étape du cycle de vie, sa source d'origine et, si vous les avez, la réponse déclarée et la date du premier contact. Envoyez l'export entier à chaque fois : c'est le dernier import des contacts qui est lu.
Les contacts sont réduits à des nombres dès la réception : entrées par étape et par mois, cohortes de leads, paires de sources. Aucune ligne, aucun nom, aucun e-mail n'est gardé, même pendant que la proposition attend.
Le tableau est lu à l'envoi par le lecteur du fichier : ce qu'il refuse revient tout de suite, avec ses lignes, numérotées à partir de 1 dans rows. Il attend ensuite qui importe les fichiers, qui voit son aperçu sur la page Données et le valide ou le refuse. Rien n'est compté avant.
Appel
| Repère | Valeur |
|---|---|
| Adresse | POST /api/v1/crm/contacts/proposals |
| Par son nom | POST /api/v1/tools/propose_contacts, la réponse sous data |
| Nom de l'outil | propose_contacts |
| Droit demandé | Importer un fichier (source.import) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, DAF |
| Par MCP | Oui : l'envoi attend une personne. |
Paramètres
Les paramètres sont dans le corps de la requête, en JSON.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
name | oui | texte, 1 à 80 caractères | Le nom de la proposition. Un envoi plus récent sous le même nom remplace celui qui attend. |
columns | oui | liste de textes, 1 à 120 éléments, chaque élément : 1 à 200 caractères | L'en-tête : les noms des colonnes, comme l'export les nomme, en français ou en anglais. |
rows | oui | liste de listes, 1 à 20 000 éléments | Les lignes, dans l'ordre des colonnes. |
rows[] | oui | liste de valeurs (texte, nombre ou null), 120 éléments au plus | Une ligne : pour chaque colonne, un texte, un nombre, ou null pour une cellule vide. Les dates au format AAAA-MM-JJ. |
Exemple
curl -X POST "$MARVESTO_URL/api/v1/crm/contacts/proposals" \
-H "x-api-key: $MARVESTO_API_KEY" \
-H "content-type: application/json" \
-d @corps.jsonLe fichier corps.json :
{
"name": "Contacts du CRM",
"columns": ["Create Date", "Became a Lead Date", "Became a Marketing Qualified Lead Date", "Became a Sales Qualified Lead Date", "Became an Opportunity Date", "Became a Customer Date", "Original Source"],
"rows": [
["2026-08-02", "2026-08-02", "2026-08-10", "2026-08-21", "2026-09-04", "2026-10-17", "Paid Search"],
["2026-09-12", "2026-09-12", "2026-09-20", null, null, null, "Organic Search"]
]
}Réponse
proposalId, rowCount (les lignes lues), firstMonth et lastMonth (les mois couverts), superseded (les propositions en attente remplacées).
{
"proposalId": "PROPOSAL_ID",
"rowCount": 2,
"firstMonth": "2026-08",
"lastMonth": "2026-09",
"superseded": 0
}Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.