Quick Start Guide

import requests

# Your API credentials
API_KEY = "YOUR_API_KEY_HERE"
API_URL = "https://roycetalk.com/api/v1/sms-api/send/"

# Prepare the SMS
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

data = {
    "phone_number": "+254712345678",
    "sender_id": "RoyceLTD",
    "text_message": "Hello! This is my first SMS from RoyceBulkSMS API."
}

# Send the SMS
response = requests.post(API_URL, json=data, headers=headers)

# Check the result
if response.status_code == 200:
    result = response.json()
    print("✓ SMS sent successfully!")
    print(f"Message ID: {result['data']['message_id']}")
    print(f"Status: {result['data']['status']}")
    print(f"Cost: KES {result['data']['cost']}")
else:
    print(f"✗ Error: {response.status_code}")
    print(response.text)