Quickstart
Get up and running with Fire SMS in minutes
⚡ Quickstart
Get up and running with Fire SMS in under 5 minutes.
Create an account
Sign up at firesms.vercel.app.
Generate an API key
Head to the API Keys section of your dashboard and click New Key. Give it a name and copy the key — you can always reveal it later using your password.
Store your API key securely. Never expose it in client-side code or public repositories.
Send your first text
Pass your API key as api_key in the request body or query string — no Authorization header needed.
curl -X POST https://firesms.vercel.app/api/v1/send \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_API_KEY",
"to": "27821234567",
"text": "Hello from Fire SMS! 🔥"
}'https://firesms.vercel.app/api/v1/send?api_key=YOUR_API_KEY&to=27821234567&text=Hello+from+Fire+SMS!+🔥async function sendSms() {
const apiKey = "YOUR_API_KEY"
const message = "Hello from Fire SMS! 🔥"
const phone = "27821234567"
const HOST = "https://firesms.vercel.app"
const apiResponse = await fetch(
`${HOST}/api/v1/send?api_key=${apiKey}&to=${phone}&text=${encodeURIComponent(message)}`
)
const data = await apiResponse.json()
console.log(data)
}
sendSms()Response
{
"message": "Sent",
"balance": 0.4,
"cost": 0.2,
"success": true
}| Field | Type | Description |
|---|---|---|
message | string | Human-readable status of the request |
balance | number | Your remaining account balance after the send |
cost | number | The cost deducted for this message |
success | boolean | true when the message was dispatched successfully |
{
"message": "Invalid apiKey",
"success": false
}Double-check your API key in the dashboard. Make sure you're not including extra spaces or line breaks when copying it, and that you haven't accidentally revoked it.
{
"message": "Insufficient balance",
"success": false
}Top up your account balance in the dashboard before sending further messages. Each SMS deducts from your balance based on the destination and message length.