Developer Onboarding
Get Monster SMS Running
in 30 Minutes
Follow these 8 steps in order. Each one builds on the last. By the end, you'll have a fully operational SMS platform with AI auto-reply.
1 Account
2 Phone
3 Contacts
4 Test SMS
5 Campaign
6 AI Agent
7 Inbox
8 API
⏱ 2 minutes
🌐 app.monstersms.ai/register
- ☐ Go to app.monstersms.ai/register
- ☐ Enter your full name, business email, and business name
- ☐ Set a password and click Create Free Account
- ☐ Check your inbox for the verification email and confirm
- ☐ Select your industry (used for template suggestions)
Tip: Use a business email, not Gmail/Hotmail. It helps with sender verification and builds trust with recipients.
You start on the Free plan with 100 messages (one-off sign-up bonus). No credit card required.
⏱ 3 minutes
📱 Settings → Phone Numbers
- ☐ Navigate to Settings → Phone Numbers
- ☐ Click Add Number and enter your Australian mobile or business number
- ☐ Receive the 6-digit verification code via SMS
- ☐ Enter the code to verify
Importing from Twilio?
Go to Settings → Phone Numbers → Import from Twilio. Enter your Twilio Account SID and Auth Token. Your number transfers immediately. No downtime, no number changes.
Required: Under the Australian Spam Act 2003, your sender identity must be verified. You cannot send messages without completing this step.
⏱ 5 minutes
📋 Contacts → Import
- ☐ Go to Contacts in the left sidebar
- ☐ Click Import and select your CSV file
- ☐ Map your CSV columns to Monster SMS fields (phone, name, company, etc.)
- ☐ Review the import preview, confirm numbers are formatted correctly
- ☐ Click Import Contacts
CSV format
At minimum, your CSV needs a phone column with Australian mobile numbers. The smart field mapper handles most formats automatically.
phone,first_name,last_name,company
+61412345678,Sarah,Johnson,Bloom Florist
0412345678,Michael,Chen,Chen Engineering
61498765432,Emma,Williams,Williams Legal
Tip: Create segments (tags or groups) during import. For example, tag all contacts from a particular source so you can target campaigns later.
Compliance: Only import contacts who have opted in to receive SMS from your business. Purchased lists violate the Spam Act and will get your account suspended.
⏱ 1 minute
💬 New Message
- ☐ Click New Message in the left sidebar
- ☐ Enter your own mobile number as the recipient
- ☐ Type a test message (watch the character counter: 160 chars = 1 credit)
- ☐ Hit Send and confirm delivery on your phone (2-5 seconds)
Example compliant message
Hi Sarah, thanks for joining Bloom Florist! Show this SMS for 10% off your next order. Reply STOP to opt out.
Every commercial SMS must: identify your business, include an opt-out mechanism, and only go to consented recipients. Monster SMS handles STOP/opt-out automatically.
⏱ 5 minutes
📨 Campaigns → New Campaign
- ☐ Go to Campaigns in the sidebar
- ☐ Click New Campaign
- ☐ Name your campaign (internal only, recipients do not see this)
- ☐ Select recipients: your full list, a segment, or a tag group
- ☐ Write your message. Use merge fields for personalisation:
{{first_name}}, {{company}}
- ☐ Choose: Send Now or Schedule for a specific date and time
- ☐ Review the preview (shows exactly what each recipient will see)
- ☐ Click Send Campaign
Merge fields
Hi {{first_name}}, {{company}} is invited to our exclusive event this Friday!
RSVP by replying YES. Reply STOP to unsubscribe.
Tip: Schedule campaigns for 10am-2pm on weekdays for the best open rates. Avoid weekends and evenings unless your audience expects it.
⏱ 10 minutes
🤖 AI Agents → Create New Agent
- ☐ Navigate to AI Agents in the sidebar
- ☐ Click Create New Agent
- ☐ Write your system prompt: describe your business, tone, and what the AI should handle
- ☐ Add FAQs or product details to the knowledge base (optional but recommended)
- ☐ Set operating hours (e.g. handle replies after 6pm and weekends)
- ☐ Assign the agent to your verified phone number
- ☐ Toggle to Active
- ☐ Test it: send an SMS to your number from another phone
Example system prompt
You are the customer service assistant for Bloom Florist, a flower shop
in Brisbane. You are friendly, helpful, and keep replies under 160 characters
when possible.
You can answer questions about:
- Opening hours: Mon-Sat 8am-6pm, Sun 9am-3pm
- Delivery: same-day for orders before 2pm, $15 flat rate within Brisbane
- Popular products: roses, mixed bouquets, orchids, wedding arrangements
For order issues or complaints, collect the customer's name and order number,
then say a team member will call them back within the hour.
Never make up information you are not sure about.
Tip: Be specific in your prompt. The more context you give the AI (prices, hours, policies), the better it handles conversations without needing human help. The current resolution rate for well-configured agents is around 94%.
⏱ 2 minutes
💬 Conversations
- ☐ Go to Conversations in the sidebar
- ☐ View all inbound and outbound SMS threads in the unified inbox
- ☐ Click into a thread to see the full conversation history
- ☐ Assign threads to team members if needed
- ☐ Use quick-reply templates for common responses
The inbox shows both human and AI-handled conversations. If the AI escalated a thread, it will be flagged for human follow-up.
⏱ 10 minutes
⚙️ Settings → API Keys
- ☐ Go to Settings → API Keys
- ☐ Generate a new API key
- ☐ Use the sandbox mode for testing (no credits consumed)
- ☐ Send your first API message
- ☐ Set up webhook callbacks for delivery status updates
Send an SMS via API
curl -X POST https://api.monstersms.ai/v1/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+61412345678",
"message": "Your order #4521 has shipped! Track at: example.com/track/4521"
}'
Node.js example
const response = await fetch('https://api.monstersms.ai/v1/send', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '+61412345678',
message: 'Your order has shipped!'
})
});
const result = await response.json();
// { "id": "msg_abc123", "status": "delivered", "credits_used": 1 }
Tip: Use the sandbox mode first. It simulates delivery without sending real messages or consuming credits. Flip to production when you are ready.
You are good to go 🎉
Account created, number verified, contacts imported, AI agent running, inbox ready.
That covers the full setup. If something is unclear, reach out to [email protected].
Open Dashboard →