SMS API — Stone the Flamin' Crows, Send a Text! 🇦🇺

Need to send a text without the headache? For the price of a text message, automate 'em. Twilio. Vonage. One API. Works every time. She'll be right.

Strike me roan! Got somethin' to say but CBF pickin' up the phone? This lil' beauty fires off SMS messages through Twilio or Vonage faster than a kangaroo in a carpark on a 40° day.

Chuck in yer creds, whack in a number, type your message, and BANG — it's off. Easy as. She'll be right, mate.

---

🔧 How to Use This Beauty

Quick Start (No Uni Degree Required, Ya Flamin' Galah)

1. Pick ya poison — Twilio or Vonage. Your call, I'm not ya mother.
2. Dump yer credentials in — API keys, tokens, all that jazz. Kept dead quiet, on the QT. None of ya business.
3. Whack in the recipient's number — gotta be E.164 format, like +614****5678. I wasn't born yesterday, it's not that hard.
4. Type your bloody message — up to 1600 characters. Keep it tight, I ain't readin' a novel.
5. Hit run — you'll get your result in the dataset quicker than a servo pie on a road trip. Wouldn't it be right?

Input Fields (The Nitty Gritty)

Stone the flamin' crows, here's what you need:

Field	Reckon?	What It Is
provider	Yeah nah, ya need this	twilio or vonage — pick a lane, don't muck about
to	Dead set required	Their number in E.164 format. Get it into ya thick skull
message	Too right, mate	What you wanna say (max 1600 chars). Keep it brief, ya magpie
accountSid	Only if Twilio	Your Twilio Account SID
authToken	Only if Twilio	Your Twilio Auth Token. Secret squirrel stuff
twilioFrom	Only if Twilio	Your Twilio number — where the text comes from
apiKey	Only if Vonage	Vonage API Key
apiSecret	Only if Vonage	Vonage API Secret
vonageFrom	Only if Vonage	Sender name or number (e.g. SMSAPI)

Your creds are locked up tighter than a Catholic schoolgirl's knickers on a Sunday — encrypted, secret, never leaked. Safe as the Bank of Summer Bay.

What You Get Back (Results, Cobber)

Each run drops a ripper result into the dataset. Fair dinkum:

{
  "success": true,
  "provider": "twilio",
  "messageId": "SMabc123...",
  "to": "+614****5678",
  "status": "sent",
  "cost": 0.095,
  "error": null
}

If it's cactus, you'll see "success": false and the error field will tell ya what went pear-shaped. Don't blame me for your stuffed credentials.

---

🐍 Call This Bad Boy From Code

You can ping this Actor from any app via the Apify API. Strike me roan, it's simple.

Python (The Fancy Way, For The Young Folk)

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

result = client.actor("YOUR_USERNAME/sms-api").call(
    run_input={
        "provider": "twilio",
        "accountSid": "AC...",
        "authToken": "your-token",
        "twilioFrom": "+123****7890",
        "to": "+614****5678",
        "message": "Oi, get the beers in!",
    }
)

dataset = client.dataset(result["defaultDatasetId"]).list_items()
print(dataset.items)

cURL (Old School, I Get It)

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~sms-api/runs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ***" \
  -d '{
    "provider": "twilio",
    "accountSid": "AC...",
    "authToken": "your-token",
    "twilioFrom": "+123****7890",
    "to": "+614****5678",
    "message": "Get the barbie fired up!"
  }'

MCP / AI Agents (What In The Name Of...)

This Actor works as an MCP tool — so Claude, Cursor, or whatever flash new-fangled AI agent young people use these days can sniff it out and fire off SMS like it's nothin'. Your bloomin' AI can now send a text. The future's here and I still don't trust it.

---

📦 Environment Variables (Set & Forget, She'll Be Right)

CBF enterin' creds every time? Set 'em once at the Actor level and rack off about it.

Variable	What It Does
TWILIO_ACCOUNT_SID	Twilio Account SID
TWILIO_AUTH_TOKEN	Twilio Auth Token
TWILIO_FROM_NUMBER	Default Twilio sender number
VONAGE_API_KEY	Vonage API Key
VONAGE_API_SECRET	Vonage API Secret
VONAGE_FROM	Default Vonage sender

Input fields beat env vars if you supply both — so you can have a default and override when needed. Got ya bases covered. Wouldn't be right if we didn't.

---

💰 How Much? (Spoiler: Cheap As Chips)

This Actor's on Pay Per Event — you only pay when it actually works:

• $0.01 per successful send — covers compute + your cut. Bloody bargain.
• Carrier fees from your provider still hit ya. That's between you and them, I'm not gettin' involved.
• Free plan users get $5/mo in credits — that's 500 texts for nicks. Even a flamin' galah can afford that.

---

🛟 Stuffed? Need A Hand?

• Somethin' cactus? — GitHub Issues
• Wanna chinwag with the crew? — Discord: Apify Developer Community

---

📄 Legalese

MIT license — go nuts. Do what you want with it. No wozzas. I'm not ya lawyer, rack off with the fine print.

---

Strike me roan. Built with 🦘 and XXXX Gold by some bloke who just wanted to send texts without all the carry-on. If ya don't like it, there's the door.

Stop typin'. Start textin'.