[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Créer une campagne

L'opération REST email.campaigns.create de Prescriptio sert à créer un brouillon de campagne et son premier message, sans envoyer immédiatement.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/email.campaigns.create \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"corps":"Bonjour [prenom], …","nom":"Relance isolation","objet":"Votre projet à [ville]"}'
```

**Corps JSON**

```json
{
  "corps": "Bonjour [prenom], …",
  "nom": "Relance isolation",
  "objet": "Votre projet à [ville]"
}
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "<campagne_creee>",
  "fields": {
    "campagne_id": "<texte>"
  },
  "note": "<texte>",
  "ok": null,
  "url": "<texte>"
}
```

## Paramètres du corps

| Nom | Type | Requis | Description |
|---|---|---|---|
| `corps` | texte | oui | creer/variante : le message. Mêmes champs. Pour un lien mesure, écrire [lien1], [lien2] et les declarer par action liens. |
| `expediteur` | texte | — | creer/modifier : adresse d'expedition. Doit appartenir a un domaine VERIFIE pour cet espace (action expediteur les liste) ou au domaine de repli de la plateforme. Laisser vide prend l'adresse par défaut de l'espace. Un domaine seulement declare est refuse : sans SPF/DKIM le message part en indesirable. |
| `expediteur_nom` | texte | — | creer/modifier : le nom affiche par la messagerie du destinataire. |
| `nom` | texte | oui | creer/modifier : nom de la campagne (120 caracteres au plus). |
| `objet` | texte | oui | creer/variante : objet du message. Champs : [prenom] [nom] [entreprise] [ville] [fonction] (l'accent est optionnel : [prenom] et [prénom] valent pareil, [société] vaut [entreprise]). |
| `repondre_a` | texte | — | creer/modifier : la boite ou arrivent les réponses (celle de l'utilisateur). Obligatoire avant de planifier. |

## En bref

| | |
|---|---|
| Adresse | `POST /api/mcp/v1/email.campaigns.create` |
| 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`](https://prescriptio.fr/docs/api/campagne_email) : 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 `email.campaigns.create`.

- [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](https://prescriptio.fr/docs/api/campagne_email) : La même action par le connecteur MCP
- [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations