Importer des contacts | Documentation Prescriptio

POST /api/mcp/v1/bdd.mailmerge.import, portée mcp:write; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil campagne_email_audiences.

exemple synthétique

curl -sS https://prescriptio.fr/api/mcp/v1/bdd.mailmerge.import \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"csv":"email;prenom;produit\[email protected];Camille;Acoustique","liste_id":"00000000-0000-0000-0000-000000000001","signature":"signature-renvoyee-par-apercu"}'

{
  "csv": "email;prenom;produit\[email protected];Camille;Acoustique",
  "liste_id": "00000000-0000-0000-0000-000000000001",
  "signature": "signature-renvoyee-par-apercu"
}

Réponsegénérée depuis le schéma

{
  "action": "<bdd_publipostage_importer>",
  "fields": {
    "enregistres": 0
  },
  "note": "<texte>",
  "ok": null,
  "url": "<texte>"
}

Paramètres du corps

csvtexterequis

Bdd publipostage : tableau CSV avec email et colonnes libres. Analyser avant importer. (max. 2000000 caractères)

liste_idtexterequis

UUID d'une liste de la base, ou audience:<UUID> pour une audience enregistrée. Creer : reprend d'un geste les contacts de cette liste de Ma base (vérifiée avant de créer).

signaturetexterequis

Empreinte rendue par bdd_publipostage_analyser, requise pour confirmer le même import.

Quand l'utiliser

Requiert sa signature. Aucun envoi d’e-mail.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

En bref

Adresse: POST /api/mcp/v1/bdd.mailmerge.import
Contrat: 3.0.0
Portée OAuth: mcp:write
Conditions d’accès: Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas.
Outil MCP: campagne_email_audiences : même traitement

Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (marches_dce, mairies_deliberations et leurs téléchargements) qui est décomptée.

Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : Codes d'erreur et Authentification et quotas.

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite bdd.mailmerge.import.

Base de donnéesDocumentation, Les modules Campagnes e-mail de bout en boutGuides, Parcours complets API RESTIA, Intégrations

Voir aussi

Référence APIL'adresse, l'authentification et les codes de réponse campagne_email_audiencesLa même action par le connecteur MCP OpenAPILe schéma machine de toutes les opérations

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Importer des contacts L'opération REST bdd.mailmerge.import de Prescriptio sert à importer en une fois le fichier CSV vérifié dans une liste de votre base. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/bdd.mailmerge.import \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"csv":"email;prenom;produit\[email protected];Camille;Acoustique","liste_id":"00000000-0000-0000-0000-000000000001","signature":"signature-renvoyee-par-apercu"}' ``` **Corps JSON** ```json { "csv": "email;prenom;produit\[email protected];Camille;Acoustique", "liste_id": "00000000-0000-0000-0000-000000000001", "signature": "signature-renvoyee-par-apercu" } ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "<bdd_publipostage_importer>", "fields": { "enregistres": 0 }, "note": "<texte>", "ok": null, "url": "<texte>" } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `csv` | texte | oui | BDD publipostage : tableau CSV avec email et colonnes libres. Analyser avant importer. (max. 2000000 caractères) | | `liste_id` | texte | oui | UUID d'une liste de la base, ou audience:<UUID> pour une audience enregistrée. creer : reprend d'un geste les contacts de cette liste de Ma base (vérifiée avant de créer). | | `signature` | texte | oui | Empreinte rendue par bdd_publipostage_analyser, requise pour confirmer le même import. | ## Quand l'utiliser Requiert sa signature. Aucun envoi d’e-mail. ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/bdd.mailmerge.import` | | Contrat | 3.0.0 | | Portée OAuth | `mcp:write` | | Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. | | Outil MCP | [`campagne_email_audiences`](https://prescriptio.fr/docs/api/campagne_email_audiences) : même traitement | ## Erreurs et quotas Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée. Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas). ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `bdd.mailmerge.import`. - [Base de données](https://prescriptio.fr/docs/base-de-donnees) : Documentation, Les modules - [Campagnes e-mail de bout en bout](https://prescriptio.fr/docs/guides/campagnes-email) : Guides, Parcours complets - [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations ## Voir aussi - [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse - [campagne_email_audiences](https://prescriptio.fr/docs/api/campagne_email_audiences) : La même action par le connecteur MCP - [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations