API : envois et réponses

Envoyer un formulaire, retrouver un envoi par votre propre identifiant, lire ou supprimer les réponses.

À quoi ça sert

Intégrer Formix à votre logiciel de dossiers : le dossier envoie, Formix répond.

Prérequis et forfait

Clé d’API. Chaque envoi compte dans le quota d’envois.

Étapes

1. POST r=send avec form_id, to_name, to_email, ref (votre identifiant, 80 caractères) et send_email (true par défaut) : crée l’envoi et renvoie son lien.
2. GET r=sends : liste (200 maximum), avec filtres form_id, ref et status=completed ou sent.
3. GET r=send&id=… : un envoi avec ses réponses. DELETE r=send&id=… : le supprime.

Résultat attendu

L’envoi est créé (201) avec "url", "status" (sent ou completed), "answers" pour GET r=send&id=.

Astuces

• Sans courriel, mettez send_email=false pour obtenir seulement le lien.
• Utilisez "ref" pour retrouver le dossier lié à l’envoi quand le webhook arrive.

Problèmes fréquents

422 « Un courriel est requis pour envoyer le lien (ou envoyez send_email=false). »

Ajoutez to_email ou mettez send_email à false.

422 « Courriel invalide. »

Corrigez to_email.

402 quota_exceeded

Quota d’envois atteint.

Pages concernées

Référence de l’API

Ces pages demandent d’être connecté.

Articles liés