Créer un coupon
post
https://mudey.fr/api/v1/couponscourses:writeLe code est mis en majuscules et unique sur toute la plateforme. Sans courseId, le coupon vaut sur toutes vos formations.
En-tête Authorization: Bearer mudey_sk_… obligatoire. Créer et utiliser une clé
Corps JSON
Les champs marqués * sont obligatoires.
| Champ | Type | Description |
|---|---|---|
| code* | string | 3 à 40 caractères : lettres, chiffres, - ou _. Mis en majuscules. |
| courseId | string | null | Formation visée (une des vôtres). null : toutes vos formations. |
| discountType* | PERCENTAGE | FIXED | PERCENTAGE : pourcentage du prix. FIXED : montant retiré. |
| discountValue* | number | Pourcentage (20 = 20 %, 12.5 accepté, 100 au plus) ou montant dans la devise de la formation. |
| maxUses | integer | null | Nombre d'utilisations au plus ; null = illimité. Jamais sous usedCount. |
| expiresAt | string | null | Échéance ISO 8601 avec fuseau (2026-12-31T23:59:59Z) ; null = sans fin. |
| isActive | boolean | Utilisable au paiement. true par défaut. |
Réponses
201Coupon créé.401Clé absente, invalide, révoquée ou expirée.403Droit manquant sur la clé, ou compte qui n'est plus formateur.404Ressource introuvable dans vos formations.409Code déjà pris (code_taken).422Données invalides (details liste les champs).429Quota dépassé (300 appels par minute et par clé). Voir l'en-tête Retry-After.
Exemple
export MUDEY_API_KEY="mudey_sk_..."
curl -X POST "https://mudey.fr/api/v1/coupons" \
-H "Authorization: Bearer $MUDEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"code": "LANCEMENT-2026",
"courseId": "…",
"discountType": "PERCENTAGE",
"discountValue": 30,
"maxUses": 100,
"expiresAt": "2026-12-31T23:59:59Z"
}'