SMS & MMS

Send and receive text messages and rich media content with PantheonCloud's reliable SMS and MMS API services.

Overview

SMS (Short Message Service) and MMS (Multimedia Messaging Service) are essential communication channels for businesses to reach customers directly on their mobile devices. PantheonCloud's SMS & MMS API provides a simple, powerful, and reliable way to integrate text and media messaging into your applications, allowing you to engage with your audience in real-time across the globe.

Global Reach

Connect with customers worldwide with high delivery rates.

Rich Media

Send images, videos, audio, and other multimedia content.

Real-time Delivery

Instant message delivery with delivery receipts and status updates.

Key Features

Two-Way Messaging

Send and receive messages to build interactive communication with your customers.

Real-time message reception
Auto-reply capabilities
Conversation tracking
Webhook integration for instant notifications

Bulk Messaging

Send mass text campaigns to your customer base with personalized content.

Personalization tokens
Scheduled delivery
Campaign analytics and reporting
Throttling controls to optimize delivery

Rich Media Support

Enhance your messaging with multimedia content to improve engagement.

Images (JPG, PNG, GIF)
Videos (up to 1.5MB)
Audio files
PDF documents
Contact cards (vCard)

Location Sharing

Share and receive location data via MMS messages.

Geo-coordinate support
Map thumbnail generation
Location-based services integration
Delivery to map applications

Security & Compliance

Enterprise-grade security and regulatory compliance.

End-to-end encryption
GDPR and CCPA compliance
Message retention policies
Opt-out management
10DLC registration support

Analytics & Insights

Comprehensive analytics to measure campaign effectiveness.

Delivery reports
Open rates (where supported)
Click tracking for URLs
Detailed logs and monitoring
Custom reporting

API Endpoints

Send SMS

POST

https://api.bitpanyun.com/v1/messages/sms

Request Body

JSON Example

{
  "to": "+14155551234",
  "from": "+14155556789",
  "text": "Hello, this is a test message from PantheonCloud!",
  "encoding": "GSM-7",
  "priority": "normal",
  "delivery_receipt": true,
  "webhook_url": "https://example.com/webhooks/message-status",
  "tags": {
    "campaign_id": "summer_promo_2023",
    "channel": "sms",
    "department": "marketing"
  }
}

Response

JSON Example

{
  "message_id": "msg-123456789",
  "to": "+14155551234",
  "from": "+14155556789",
  "text": "Hello, this is a test message from PantheonCloud!",
  "status": "queued",
  "segments": 1,
  "direction": "outbound",
  "type": "sms",
  "created_at": "2023-07-15T10:30:00Z",
  "cost": 0.005,
  "currency": "USD"
}

Send MMS

POST

https://api.bitpanyun.com/v1/messages/mms

Request Body

JSON Example

{
  "to": "+14155551234",
  "from": "+14155556789",
  "text": "Check out our new product!",
  "media_urls": [
    "https://example.com/images/product.jpg",
    "https://example.com/videos/demo.mp4"
  ],
  "media_captions": [
    "Our new flagship product",
    "Product demonstration video"
  ],
  "delivery_receipt": true,
  "webhook_url": "https://example.com/webhooks/message-status",
  "tags": {
    "product_id": "P12345",
    "campaign": "new_product_launch"
  }
}

Response

JSON Example

{
  "message_id": "msg-987654321",
  "to": "+14155551234",
  "from": "+14155556789",
  "text": "Check out our new product!",
  "media_urls": [
    "https://example.com/images/product.jpg",
    "https://example.com/videos/demo.mp4"
  ],
  "status": "queued",
  "segments": 1,
  "direction": "outbound",
  "type": "mms",
  "created_at": "2023-07-15T10:30:00Z",
  "cost": 0.025,
  "currency": "USD"
}

Get Message Status

GET

https://api.bitpanyun.com/v1/messages/{message_id}

Response

JSON Example

{
  "message_id": "msg-123456789",
  "to": "+14155551234",
  "from": "+14155556789",
  "text": "Hello, this is a test message from PantheonCloud!",
  "status": "delivered",
  "status_details": "Message successfully delivered to recipient",
  "segments": 1,
  "direction": "outbound",
  "type": "sms",
  "created_at": "2023-07-15T10:30:00Z",
  "updated_at": "2023-07-15T10:30:15Z",
  "delivered_at": "2023-07-15T10:30:15Z",
  "cost": 0.005,
  "currency": "USD",
  "tags": {
    "campaign_id": "summer_promo_2023",
    "channel": "sms",
    "department": "marketing"
  }
}

Error Codes

Code	Description	Resolution
SMS_001	Invalid phone number format	Verify the phone number is in E.164 format (+1234567890)
SMS_002	Message content too long	Shorten your message or use URL shortening for links
SMS_003	Insufficient funds	Add funds to your account or adjust your service plan
SMS_004	Recipient opted out	Remove this number from your contact list
MMS_001	Media file too large	Compress your media files to under 1.5MB
MMS_002	Unsupported media format	Use supported formats: JPG, PNG, GIF, MP4, PDF, etc.
SMS_005	Spam detected	Review content policies and resend with appropriate content
SMS_006	Sender ID not registered	Register your sender ID for the target country