Morocco SMS API: Complete Integration Guide (2026)

Connecting to Moroccan mobile networks requires understanding the local telecom topography. The three licensed MNOs—Maroc Telecom (IAM), Orange Maroc, and Inwi—serve over 50 million active mobile lines. Utilizing legitimate local routes via EnvoiSMS.ma, with automatic failover between routes, keeps latency minimal (under 3 seconds) and avoids unreliable international gray routes.

Moroccan mobile numbers use the +212 country code followed by a 9-digit subscriber number starting with 6 or 7 (e.g., +212 6XX-XXXXXX or +212 7XX-XXXXXX). The EnvoiSMS API automatically sanitizes localized formats (06..., 07..., 00212...) to ensure reliable delivery and prevent credit loss on malformed requests.

EnvoiSMS provides an intuitive REST interface at https://api.envoisms.ma/v1/messages. You authenticate requests using a bearer API key (env_live_...) in the HTTP Authorization header. Outbound payloads accept JSON containing recipient numbers, message body, channel selection (sms, whatsapp_direct, waba), and optional custom sender IDs.

Delivery receipts are dispatched via asynchronous HTTP POST webhooks to your callback URL. Each delivery report contains standard status events (sent, delivered, failed) and is cryptographically signed with an HMAC-SHA256 signature, enabling your server to verify payload authenticity before updating local database records.

Before deploying to live traffic, developers can test workflows against our sandbox environment (is_sandbox: true). EnvoiSMS enforces dual-currency balances (MAD / EUR at an 11.0 fixed rate) with per-SMS pricing from 0.48 MAD (Enterprise plan, validated Sender ID) to 0.792 MAD (shared sender) depending on your plan and Sender ID, providing full financial predictability.