Envoyer un SMS

POST/v1/messages/send

Paramètres du corps (JSON)

Champ	Type	Description
to requis	string	Numéro du destinataire au format international, par exemple +212612345678.
content requis	string	Texte du message, 2 048 caractères maximum. Un SMS fait 160 caractères (70 avec des accents ou de l’arabe) ; au-delà, il est découpé et chaque partie est facturée.
from	string	Numéro d’envoi parmi vos numéros. Si vous l’omettez, GetSMS choisit un numéro du pool, toujours le même pour un destinataire donné.
request_id	string	Votre identifiant (255 caractères maximum), renvoyé dans le message et les événements. Pratique pour relier un SMS à une commande, une facture ou un dossier.
send_at	string, ISO 8601	Date d’envoi programmé, 20 jours (480 heures) maximum dans le futur.
sender_id (bientôt)	string	Nom d’expéditeur validé, 11 caractères maximum. Voir Nom d’expéditeur.

Exemple de réponse 200

{
  "status": "success",
  "message": "message added to queue",
  "data": {
    "id": "32343a19-da5e-4b1b-a767-3298a73703cb",
    "request_id": "commande-8841",
    "owner": "+212661234501",
    "contact": "+212612345678",
    "content": "Commande #8841 : 349 DH, livraison demain à Rabat.",
    "type": "mobile-terminated",
    "status": "pending",
    "send_attempt_count": 0,
    "max_send_attempts": 2,
    "request_received_at": "2026-11-10T09:12:03Z",
    "sent_at": null,
    "delivered_at": null,
    "failure_reason": null
  }
}

owner est le numéro qui envoie, contact le destinataire. La réponse complète contient aussi les autres horodatages (scheduled_at, expired_at, failed_at…).