Skip to main content

​
Endpoint

POST /api/v1/messages/send

​
Body

ChampTypeRequisDescription
instanceIdUUIDouiInstance source
tostringouiNuméro E.164
typeenumoui si pas de templateIdtext, image, video, audio, document, voice_note, location, contact
templateIdUUIDoui si pas de typeTemplate à rendre
textstringselon typeCorps du message
mediaUrlstringselon typeURL publique du media
latitudenumbersi locationLatitude
longitudenumbersi locationLongitude
locationNamestringnonNom du lieu
locationAddressstringnonAdresse
contactIdUUIDnonContact partagé ou contexte template
variablesobjectnonValeurs custom.*

​
Exemple de requête

curl -X POST https://srv.msgflash.com/api/v1/messages/send \
  -H "x-api-key: msgf_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "instanceId": "INSTANCE_UUID",
    "to": "+22912345678",
    "type": "text",
    "text": "Bonjour"
  }'

​
Réponse succès 201

{
  "data": {
    "id": "msg_uuid",
    "instanceId": "inst_uuid",
    "contactId": null,
    "campaignId": null,
    "type": "text",
    "to": "+22912345678",
    "body": "Bonjour",
    "mediaUrl": null,
    "status": "queued",
    "error": null,
    "providerMessageId": null,
    "createdAt": "2026-04-01T10:00:00.000Z",
    "updatedAt": "2026-04-01T10:00:00.000Z"
  }
}

​
Erreurs courantes

HTTPCodeQuand
400VALIDATION_ERRORBody invalide
400TEMPLATE_INVALIDTemplate invalide
400TEMPLATE_VARIABLES_MISSINGVariables requises manquantes
400TEMPLATE_CONTEXT_UNAVAILABLEContact ou instance de contexte invalide
403SUBSCRIPTION_INACTIVESouscription non exploitable
404NOT_FOUNDInstance, contact ou template introuvable
429MONTHLY_OUTBOUND_QUOTA_EXCEEDEDQuota d’envoi épuisé