Créer une audience | Documentation Prescriptio

POST /api/mcp/v1/email.audiences.create, 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/email.audiences.create \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"filtre":"Lyon","nature":"segment","nom":"Architectes de Lyon","source":"base"}'

{
  "filtre": "Lyon",
  "nature": "segment",
  "nom": "Architectes de Lyon",
  "source": "base"
}

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

{
  "action": "<audiences | audience_creer | audience_modifier | audience_supprimer>",
  "fields": {
    "audiences": [
      {
        "id": "<texte>",
        "nature": "<liste | segment>",
        "nom": "<texte>",
        "selection": {
          "contacts": [
            null
          ],
          "liste_id": "<texte>",
          "q": "<texte>",
          "rang_max": 0,
          "source": "<texte>"
        }
      }
    ]
  },
  "note": "<texte>",
  "ok": null,
  "url": "<texte>"
}

Paramètres du corps

contactsliste

Identifiants base:<UUID> ou crm:<UUID> déjà détenus par l'organisation.

filtretexte

Destinataires : texte libre sur le nom, la société, la ville ou l'adresse.

liste_idtexte

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).

naturetexterequis

(valeurs : liste · segment)

nomtexterequis

Creer/modifier : nom de la campagne (120 caracteres au plus).

rang_maxentier

destinataires : 1 décideurs seuls, 2 jusqu'a prioritaire, 3 jusqu'a secondaire, 4 tout le monde (défaut). (min 1, max 4)

sourcetexte

Destinataires : ou chercher. Crm = le carnet de contacts, base = Ma base (coordonnées revelees seulement), tous = les deux. (valeurs : tous · crm · base)

En bref

Adresse: POST /api/mcp/v1/email.audiences.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_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.

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

curl -sS https://prescriptio.fr/api/mcp/v1/email.audiences.create \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"filtre":"Lyon","nature":"segment","nom":"Architectes de Lyon","source":"base"}'

{ "action": "<audiences | audience_creer | audience_modifier | audience_supprimer>", "fields": { "audiences": [ { "id": "<texte>", "nature": "<liste | segment>", "nom": "<texte>", "selection": { "contacts": [ null ], "liste_id": "<texte>", "q": "<texte>", "rang_max": 0, "source": "<texte>" } } ] }, "note": "<texte>", "ok": null, "url": "<texte>" }

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Créer une audience L'opération REST email.audiences.create de Prescriptio sert à créer une liste de contacts ou un segment dynamique. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/email.audiences.create \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"filtre":"Lyon","nature":"segment","nom":"Architectes de Lyon","source":"base"}' ``` **Corps JSON** ```json { "filtre": "Lyon", "nature": "segment", "nom": "Architectes de Lyon", "source": "base" } ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "<audiences | audience_creer | audience_modifier | audience_supprimer>", "fields": { "audiences": [ { "id": "<texte>", "nature": "<liste | segment>", "nom": "<texte>", "selection": { "contacts": [ null ], "liste_id": "<texte>", "q": "<texte>", "rang_max": 0, "source": "<texte>" } } ] }, "note": "<texte>", "ok": null, "url": "<texte>" } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `contacts` | liste | — | Identifiants base:<UUID> ou crm:<UUID> déjà détenus par l'organisation. | | `filtre` | texte | — | destinataires : texte libre sur le nom, la société, la ville ou l'adresse. | | `liste_id` | texte | — | 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). | | `nature` | texte | oui | (valeurs : `liste` · `segment`) | | `nom` | texte | oui | creer/modifier : nom de la campagne (120 caracteres au plus). | | `rang_max` | entier | — | destinataires : 1 décideurs seuls, 2 jusqu'a prioritaire, 3 jusqu'a secondaire, 4 tout le monde (défaut). (min 1, max 4) | | `source` | texte | — | destinataires : ou chercher. crm = le carnet de contacts, base = Ma base (coordonnées REVELEES seulement), tous = les deux. (valeurs : `tous` · `crm` · `base`) | ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/email.audiences.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_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). ## 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