Skip to main content

Endpoint

POST /api/v1/messages/schedule

Body

ChampTypeRequisDescription
instanceIdUUIDouiInstance source
tostringouiNuméro E.164
scheduledAtISO 8601ouiDate/heure d’envoi
typeenumoui si pas de templateIdType du message libre
templateIdUUIDoui si pas de typeTemplate à rendre
variablesobjectnonValeurs custom.*
Les autres champs suivent les mêmes règles que /messages/send.

Exemple de requête

curl -X POST https://srv.msgflash.com/api/v1/messages/schedule \
  -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 dans 30 minutes",
    "scheduledAt": "2026-04-02T08:00:00.000Z"
  }'

Réponse succès 201

{
  "data": {
    "id": "msg_uuid",
    "status": "queued"
  }
}

Erreurs courantes

HTTPCodeQuand
400VALIDATION_ERRORBody invalide
400TEMPLATE_INVALIDTemplate invalide
404NOT_FOUNDInstance, contact ou template introuvable
429MONTHLY_OUTBOUND_QUOTA_EXCEEDEDQuota déjà épuisé