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

# Créer une alerte

L'opération REST alertes.create de Prescriptio sert à créer une alerte autorisée.

> **Attention :** Créer l’alerte n’envoie pas d’e-mail pendant l’appel. Cela ne garantit pas son exclusion des récapitulatifs ultérieurs : le traitement relit les préférences de notification du compte et du type d’événement. L’absence de contrôle du canal de l’alerte sur ce chemin est déduite du code local, non vérifiée par un essai d’envoi. Vérifiez **Paramètres › Notifications** ; ce réglage concerne le compte, pas seulement cette alerte.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/alertes.create \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"departement":"69","frequency":"daily","name":"Veille synthétique isolation","query":"isolation","sources":["marche"]}'
```

**Corps JSON**

```json
{
  "departement": "69",
  "frequency": "daily",
  "name": "Veille synthétique isolation",
  "query": "isolation",
  "sources": [
    "marche"
  ]
}
```

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

```json
{
  "action": null,
  "alerte": {
    "created_at": "<texte>",
    "departements": [
      "<texte>"
    ],
    "evaluee": "<texte>",
    "frequency": "<texte>",
    "id": "<texte>",
    "is_active": false,
    "kind": "<texte>",
    "montant_min": 0,
    "name": "<texte>",
    "query": "<texte>",
    "sources": [
      "<texte>"
    ],
    "sources_surveillees": [
      "<texte>"
    ]
  },
  "created": false,
  "unchanged": false,
  "warnings": [
    "<texte>"
  ]
}
```

## Paramètres du corps

| Nom | Type | Requis | Description |
|---|---|---|---|
| `departement` | texte | — | Code département (01-95, 2A, 2B, 971-978). Filtre aussi les attributions sur leur département renseigné ; un contrat sans département reste hors d’une alerte départementale. Sur la source dce, restreint aux dossiers rapprochés d’un marché. |
| `departements` | liste | — | Plusieurs codes département (mêmes regles que département) : une région = la liste de ses départements. |
| `frequency` | texte | — | Espacement MINIMAL du rejeu (défaut daily). Le robot passe toutes les 3 heures : realtime = a chaque passage, daily = au plus une fois par jour, weekly = une fois par semaine. (valeurs : `realtime` · `daily` · `weekly`) |
| `montant_min` | nombre | — | Montant minimum en euros. S'applique a la source attribution UNIQUEMENT (DECP, montant renseigne). Sans effet sur marché, dce et permis : le montant estimé n'est publié que sur 0,12 % des avis ouverts, le filtre y viderait l'alerte. (min 0) |
| `name` | texte | oui | Nom de l'alerte (requis pour add). Reutiliser un nom existant avec d'AUTRES criteres est une erreur : supprimer puis recreer. (max. 120 caractères) |
| `query` | texte | oui | Mots-cles rejoues (requis pour add, 2 caracteres minimum). Une liste separee par des virgules vaut un OU. (max. 500 caractères) |
| `sources` | liste | — | Sources surveillables, défaut = toutes. marché = nouveaux avis publiés, plus un rappel quand la remise approche (J-7) ; dce = nouveaux dossiers de consultation citant vos termes ; attribution = marchés attribués (DECP) citant vos termes, dans les départements suivis ; permis = permis autorisés des 45 derniers jours (Sitadel, publié par dumps) ; reseaux_sociaux = nouveaux posts observés sur les réseaux sociaux citant vos termes ; mairie = nouveaux PV de conseils municipaux citant vos termes ; bodacc = nouvelles annonces légales (BODACC) citant vos termes ; entreprise = nouvelles entreprises de l'annuaire citant vos termes ; contact = nouveaux contacts de l'annuaire citant vos termes ; dvf = ventes immobilières récentes des départements suivis (le terme n'y est pas appliqué) ; site = nouvelles pages de sites d'entreprises citant vos termes. Aucune autre source n'est surveillable : une valeur hors de cette liste est REFUSEE. |

## Quand l'utiliser

Même nom et mêmes critères : rejeu sans duplication ; critères différents : conflit. Le cron évalue périodiquement, sans garantie de temps réel amont.

## En bref

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

- [Alertes](https://prescriptio.fr/docs/alertes) : Documentation, Les modules
- [Événements et relève](https://prescriptio.fr/docs/integrations/evenements) : IA, Intégrations
- [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations
- [Événements d'alerte](https://prescriptio.fr/docs/reference/evenements) : Référence, Pour commencer

## Voir aussi

- [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse
- [evenements_alertes](https://prescriptio.fr/docs/api/evenements_alertes) : La même action par le connecteur MCP
- [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations