---
title: "Préférences de notification"
description: "Lire et modifier les préférences de notification de l'utilisateur authentifié."
canonical: https://developer.billabex.com/fr/guides/preferences-de-notification/
lang: fr
alternate: https://developer.billabex.com/en/guides/notification-preferences/
last-updated: 2026-10-26
---

# Préférences de notification

> Lire et modifier les préférences de notification de l'utilisateur authentifié.

Source: https://developer.billabex.com/fr/guides/preferences-de-notification/
Langue: Français (fr)
Version anglaise: https://developer.billabex.com/en/guides/notification-preferences/

Les préférences de notification appartiennent à l'utilisateur authentifié et valent pour toutes ses
organisations. Les deux endpoints exigent le scope OAuth `profile`.

## Lire les préférences

```http
GET /api/public/v1/users/me/notification-preferences
Authorization: Bearer ACCESS_TOKEN
```

```json
{
  "digestFrequency": "Weekly",
  "newsletter": true,
  "lowCreditBalanceAlerts": true
}
```

`digestFrequency` accepte `Daily`, `Weekly`, `Biweekly`, `Monthly` ou `Never`. Un utilisateur qui
n'a jamais modifié ses préférences est en `Daily`, et l'abonnement à la newsletter vaut `true` par
défaut.

## Modifier les préférences

La mise à jour est partielle. Un champ omis conserve sa valeur actuelle.

```http
PATCH /api/public/v1/users/me/notification-preferences
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "digestFrequency": "Monthly",
  "newsletter": false,
  "lowCreditBalanceAlerts": false
}
```

Un champ inconnu, une fréquence invalide ou une valeur non booléenne pour `newsletter` renvoient
`400 Bad Request`.


`lowCreditBalanceAlerts` est un booléen activé par défaut. Il pilote les alertes sous 12 crédits
pour toutes les organisations où l'utilisateur est administrateur et qui ont déjà été rechargées.
Une première alerte est suivie d'un rappel hebdomadaire tant que le solde reste bas. Le contrôle
quotidien conserve au moins sept jours entre les envois d'une même recharge et d'un même
administrateur, sans rattrapage des semaines manquées. Une nouvelle recharge effective réarme
la première alerte.

Ce champ se modifie indépendamment du résumé et de la newsletter. Un champ omis conserve sa
valeur. Les emails concernés comportent un lien vers Mon compte > Notifications ; les adresses
et préférences des autres membres ne sont pas exposées.

---

Billabex developer portal. OpenAPI specification: https://developer.billabex.com/openapi.json.
Agent instructions: https://developer.billabex.com/llms.txt. Complete documentation: https://developer.billabex.com/llms-full.txt.