SMS

Send and receive SMS messages programmatically — with sender profiles, delivery tracking, scheduled sending, and webhook callbacks.

What it is

SMS in WAYSCloud lets developers and teams send transactional and bulk SMS messages via API. Configure sender profiles, track delivery status, and receive inbound messages through webhooks.

Support for alphanumeric sender IDs, scheduled sending, and contact group targeting.

When to use

Use this when you need:

• Transactional notifications (order confirmations, alerts, reminders)
• Bulk messaging to contact groups
• Two-way SMS with inbound webhook support
• Scheduled messages with timezone awareness

When NOT to use:

• OTP/verification codes — use Verify (purpose-built for 2FA)
• Email notifications — use transactional email

How it works

Sending an SMS:

1. Create a sender profile (phone number or alphanumeric ID)
2. Send a message to one or more recipients
3. Track delivery status via API or webhook callbacks
4. Receive replies via inbound webhooks

Messages are queued and delivered within seconds.

Features

WAYSCloud SMS is designed for reliable, programmatic messaging at scale.

Sending

• Single and bulk message sending (up to 1000 recipients)
• Alphanumeric sender IDs (e.g., 'MyBrand')
• Scheduled sending with timezone support
• Contact and group targeting

Tracking

• Real-time delivery status (queued, sent, delivered, failed)
• Webhook callbacks for delivery events
• Usage statistics and billing per period

Management

• Sender profile management with approval workflow
• SMS keyword reservation for inbound routing
• Contact directory with group organization

Getting started

All SMS functionality is available via the WAYSCloud API.

Create sender profile

Create a new sender profile (sender ID).

Sender ID Types:

• Phone number: Your own number or a dedicated number
• Alphanumeric: Brand name (max 11 chars, no ÆØÅ, requires brand_confirmation)

Custom alphanumeric sender IDs require admin approval and may have a monthly fee.

curl -X POST https://api.wayscloud.services/v1/sms/sender-profiles \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "marketing",
  "sender_id": "MyBrand",
  "allow_reply": false,
  "brand_confirmation": true
}'

List messages

List sent and received SMS messages with optional filters.

curl https://api.wayscloud.services/v1/sms/messages \
  -H "X-API-Key: YOUR_API_KEY"

List sender profiles

List your configured sender profiles (sender IDs).

curl https://api.wayscloud.services/v1/sms/sender-profiles \
  -H "X-API-Key: YOUR_API_KEY"

See all 10 endpoints in the SMS API reference.

Limits and quotas

Limits and quotas depend on the selected plan and region. See the dashboard or API for current constraints.

Related services

• Verify (OTP/2FA)

Open SMS in dashboard