⚡ Quickstart

Get up and running with Fire SMS in under 5 minutes.

Create an account

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


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


https://firesms.vercel.app/api/v1/send?api_key=YOUR_API_KEY&to=27821234567&text=Hello+from+Fire+SMS!+🔥

JavaScript


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

Success


{
  "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

Invalid API Key


{
  "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.

Insufficient Funds


{
  "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.