Skip to content

An SMS is not being sent: check the status, find the cause, fix it

Updated:

On this page

Start by working out what exactly you see. Two minutes finding the status saves an hour of guessing.

Step 1. Find the message and its status

  1. In the dashboard, open Message history.
  2. Find the message and read its status: Pending, Dispatched, Sent, Delivered, Failed or On hold.
  3. For Failed, click the message. The red “Delivery failed” box shows a code and an error text. The text comes from the phone.

Step 2. Follow the status

If the status is Pending or Dispatched → the phone has not confirmed the send. The server has asked for the send and the phone has not done it yet. Typical causes: Android put the app to sleep in the background, or the phone has no internet. Follow The phone shows “offline”. Also check in the app that the gateway is on.

If the status is On hold → the bulk send is paused. The campaign was paused by hand or automatically: the anti-ban shield stops it after 5 failed SMS in a row by default. Find the cause, then click Resume. See Anti-ban shield: pace and pauses.

If the status is Sent → the phone sent it and the carrier has not confirmed. This is usually not an error. Ask the recipient whether the message arrived.

If the status is Failed → read the code and text:

  • PERMISSION_DENIED or “SMS permission not granted” → the app has no SMS permission. Open Settings → Apps → SMS Portal|app → Permissions and set SMS to Allow. On Android 15 and newer, first choose “Allow restricted settings” in the menu (⋮). Details: SMS and notification permissions.
  • “Mobile radio is off” → airplane mode is on or the mobile network is off. Turn airplane mode off.
  • “No cellular service” or “Network error” → no signal. Try again when the phone is back on the network.
  • “Device/carrier send limit reached” → too many SMS in a short time. Wait a few minutes and slow down. See The carrier blocked sending.
  • “SMS failed on device” → the phone reported a general failure. The listed causes are: no credit on the SIM, weak signal or a carrier block. Check the balance and signal.
  • “invalid format or carrier issue” → try a shorter message or a different recipient. See Special characters and SMS length.
  • “Short code not allowed” → short numbers do not work on this carrier. Use a full phone number.

Step 3. If none of this fits

  • Verify your email address. Without it the dashboard will not let you send an SMS.
  • Check the recipient number. The send form rejects numbers shorter than 7 or longer than 15 digits.
  • Check your plan limit. Every accepted recipient uses the limit, including scheduled or failed sends.
  • In Shoper or WordPress, check the STOP list. A number that replied STOP gets no more automatic SMS. See SMS consent and opt-out.

What next

Questions and answers

The status is Sent but not Delivered. Is that an error?
Not necessarily. The phone recorded the send, and some carriers do not confirm delivery. The app then notes that the message may still have been delivered.

Didn’t find the answer? Contact us

Send your first SMS today

Create a free account, connect your phone and see how customers respond to messages from your number.