Un seul appel : vitef rend la lettre, l’imprime, la met sous pli et la remet à La Poste, puis vous tient informé de chaque étape.
POST/v1/mailings
Paramètres
mode : simple (lettre prioritaire, 2,20 € HT), rec (recommandée, 7,90 € HT) ou ar (recommandée avec accusé de réception, 9,40 € HT). Prix du premier palier, voir les tarifs.
letter, provider, values, sender : comme pour le rendu (lettre du catalogue).
ou doc : une lettre libre déjà rédigée (par vous ou par l’IA), avec title, sender, recipient, place, date, subject, body (paragraphes) et signature.
reference (facultatif) : votre référence, 30 caractères (lettres, chiffres, espace, _ et -). Elle revient dans l’envoi et les webhooks.
signatureImage (facultatif) : signature dessinée, en data URL PNG, imprimée au-dessus du nom.
{
"title": "Lettre de résiliation SFR",
"mode": "ar",
"modeLabel": "Recommandé avec AR",
"status": "paid",
"statusLabel": "Payée",
"step": 0,
"lastStep": 5,
"trackingNumber": "1A15760000001",
"createdAt": "2026-09-23T10:00:00.000Z",
"events": [
{
"step": 0,
"status": "paid",
"label": "Payée",
"at": "2026-09-23T10:00:00.000Z"
}
],
"id": "e1209b63-3764-49e3-bf9c-154e9be830da",
"orderId": null,
"recipient": [
"SFR Résiliation",
"TSA 30103",
"69947 Lyon Cedex 20"
],
"amountCents": 0,
"reference": "BAIL-2026-042",
"test": true,
"proofs": [],
"document": {
"title": "Lettre de résiliation SFR",
"sender": [
"Camille Martin",
"12 rue des Lilas",
"69003 Lyon"
],
"recipient": [
"SFR Résiliation",
"TSA 30103",
"69947 Lyon Cedex 20"
],
"place": "Lyon",
"date": "23 septembre 2026",
"subject": "Résiliation de mon abonnement SFR",
"body": [
"Madame, Monsieur,",
"Par la présente, je vous informe de ma décision de résilier mon abonnement internet SFR, identifiant client 0612345678, en raison de mon déménagement.",
"Conformément à l’article L224-39 du Code de la consommation, cette résiliation prendra effet dans un délai de 10 jours à compter de la réception de ce courrier.",
"Je vous remercie de m’en accuser réception et de m’indiquer les modalités de restitution du matériel.",
"Je vous prie d’agréer, Madame, Monsieur, l’expression de mes salutations distinguées."
],
"signature": "Camille Martin"
}
}
Lettre libre
Requête
curl -X POST "https://app.vitef.com/v1/mailings" \
-H "Authorization: Bearer $VITEF_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"doc": {
"title": "Mise en demeure",
"sender": [
"Camille Martin",
"12 rue des Lilas",
"69003 Lyon"
],
"recipient": [
"SARL Exemple",
"5 avenue Jean Jaurès",
"69007 Lyon"
],
"place": "Lyon",
"date": "24 septembre 2026",
"subject": "Mise en demeure de payer",
"body": [
"Madame, Monsieur,",
"Je vous mets en demeure de me régler la somme de 900 € sous huit jours.",
"Je vous prie d’agréer, Madame, Monsieur, mes salutations distinguées."
],
"signature": "Camille Martin"
},
"mode": "rec",
"reference": "RELANCE-77"
}'
Adresses
Pour un envoi postal, l’expéditeur et le destinataire doivent comporter un nom, une rue (ou une boîte postale : BP, TSA, CS), un code postal à 5 chiffres et une ville. Sinon : 422 address_invalid, avant tout envoi et toute facturation.
Facturation
Chaque envoi live est débité de votre crédit au prix HT de son palier du mois (rang de l’envoi, par mode), avant d’être posté. Un envoi en erreur est recrédité. Crédit insuffisant : 402 insufficient_balance, rien n’est posté.