FAQ
What is SMSFabric?
Section titled “What is SMSFabric?”An API in front of your own Android phones and SIMs. You pair a phone, and your code sends and receives SMS through it with POST /v1/messages and webhooks, instead of renting numbers from an SMS provider.
Who pays for the SMS?
Section titled “Who pays for the SMS?”The SIM that sends it pays its carrier, exactly as if you had sent the SMS from the phone’s own messaging app. Check your SIM plan’s SMS allowance and fair-use terms before sending at volume.
Can I send from an iPhone?
Section titled “Can I send from an iPhone?”No. iOS doesn’t let apps send SMS in the background or read incoming SMS. The iOS app is a companion: it shows your account and lets you send a message with a tap. Use Android phones as gateways. See iOS companion.
How many messages can one phone send?
Section titled “How many messages can one phone send?”With the default cooldown (3 seconds plus up to 2 seconds of jitter), about 14 a minute. Carriers also limit SIMs, and those limits vary. To send faster, put several phones in a pool, or spread a campaign over more time with ratePerMinute.
What happens when my phone is offline?
Section titled “What happens when my phone is offline?”Messages wait in the queue as queued or routed. SMSFabric tries to wake the phone by push. With a pool, they move to another online phone. You can subscribe to device.offline to be alerted. See Troubleshooting.
Can I send Arabic?
Section titled “Can I send Arabic?”Yes. Arabic text uses UCS2 encoding: 70 characters for a single SMS, 67 for each part of a longer one. The API reports encoding and segments on every message. The portal and docs are available in Arabic too.
How do I know a message arrived?
Section titled “How do I know a message arrived?”Its status becomes delivered when the handset confirms it. Poll GET /v1/messages/:id or subscribe to message.delivered. See Track delivery.
Do you store message text?
Section titled “Do you store message text?”Yes, encrypted with AES-256-GCM, so you can see your history in the portal and the API. Verification codes are hidden from every view. See Security.
How do I test without sending real SMS?
Section titled “How do I test without sending real SMS?”Use an sf_test_ key. The sandbox processes and reports messages without a phone. See Sandbox.
Can a recipient unsubscribe?
Section titled “Can a recipient unsubscribe?”Yes. A reply of STOP (or إيقاف, and other stop words) adds the sender to your blacklist and opts the contact out of campaigns. START reverses it. See STOP and START.
Is there an SDK?
Section titled “Is there an SDK?”A Node.js SDK, @smsfabric/sdk, with types, retries, pagination and webhook verification. See Node SDK. For other languages, the REST API is plain JSON over HTTPS; every guide has cURL, Python and PHP examples.
Can an AI assistant use SMSFabric?
Section titled “Can an AI assistant use SMSFabric?”Yes, through the MCP server, @smsfabric/mcp-server. See MCP server.
What does 404 mean when the id is right?
Section titled “What does 404 mean when the id is right?”The object belongs to a different organization than your API key. Check which organization the key was created in.