SMS API
Send and receive text messages globally through direct carrier connections. Full delivery visibility, automatic encoding, and webhook-driven architecture.
Capabilities
Outbound SMS
Send transactional and notification messages to 180+ countries with alphanumeric sender IDs.
Inbound SMS
Receive messages on your dedicated numbers. Payloads delivered via webhooks in real time.
Delivery Receipts
Track every message with carrier-level delivery status updates pushed to your webhook endpoint.
Automatic Encoding
GSM-7 and UCS-2 encoding handled automatically. Long messages split and reassembled transparently.
Rate Limiting
Configurable per-second throughput with automatic queuing and backpressure handling.
Webhook Retry
Exponential backoff with configurable retry policies. Failed deliveries are logged and retrievable via API.
Simple to integrate
Send your first SMS with a single API call. No SDK required.
const response = await fetch('https://api.villip.xyz/v1/sms/messages', {
method: 'POST',
headers: {
'X-Villip-Key-ID': `${keyId}`,
'X-Villip-Key-Secret': `${keySecret}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '+447700900000',
from: 'Villip',
body: 'Your order #1234 has shipped.'
})
});
const data = await response.json();
console.log(data.data.id); // "msg_01HXYZ..."// Delivery receipt webhook payload
{
"event": "sms.delivery_receipt",
"data": {
"id": "msg_01H...",
"to": "+447700900000",
"status": "delivered",
"timestamp": "2026-04-10T10:30:00Z"
}
}Coming Soon
The SMS API is under active development. Explore the documentation to preview the integration experience.
View Documentation