FAQ
Bulk SMS FAQ
Questions and answers about PortSMS bulk SMS sending, accounts, pricing and top-ups, delivery results and the SMS API.
10 questions
Bulk SMS pricing and getting started
What is PortSMS?
PortSMS is a bulk SMS gateway and SMS API for 227 countries. Send from a web sender or a REST API, with a published price per SMS for every country and automatic refunds to the credit for undelivered SMS.
How do I send bulk SMS?
Create an account and top up $40 or more. On the Send page, paste numbers or upload a CSV (up to 10,000 per send) and write the message. The part count and the total are shown before you pay, and sending starts when you press Send. Through the API, one POST /api/v1/messages request takes up to 1,000 numbers.
How is the price worked out?
Every country has a price per SMS part. A message costs that price times its number of parts, for each number you send it to. The calculator and the Send page show the total before anything is taken from your credit.
How many characters fit in one SMS part?
160 GSM-7 characters (Latin letters, digits and common symbols), or 70 when the text needs Unicode, for example emoji, Korean, Arabic, Cyrillic, Thai or Chinese. Longer texts are split into parts of 153 or 67 characters, up to 10 parts.
What happens to a message that is not delivered?
When a carrier reports a message as not delivered, its price goes back to your credit automatically, and the history shows it as refunded. Numbers left out in the check before sending are not charged.
How do I top up?
Press the top-up button and a secure PayGate (paygate.cx) checkout window opens. Choose an amount from $40 to $5,000, the coin and network (25 payment options including USDT, USDC, BTC, ETH and TON), enter an email for your receipt, and send the exact amount shown to the address shown.
How fast is credit available?
As soon as the network confirms the payment, usually within a few minutes. The checkout shows the progress at each step.
Can I test before a full campaign?
Yes. A test send to one number from the Send page costs only that country's price, so you can read the message on your own phone first.
Can I send SMS from my own website or app?
Yes. Create an API key in the console and send a POST request to /api/v1/messages from your website, app, CRM or script. The same prices, scheduling and refunds apply as on the web, and delivery results come back by signed webhook.
What makes PortSMS a low-cost SMS gateway?
Each of the 227 countries has its own published price per SMS part, starting at $0.0025, and you pay only for the parts you send. Credit is prepaid in US dollars and never expires, the first top-up adds bonus credit, and undelivered SMS are refunded.
6 questions
Account and sign-in
How do I sign in?
Your account is a personal sign-in token you save when you create it. Paste it on any device to sign in.
Where should I keep my token?
In a password manager, or in the .txt file you can download when the account is created. The token is stored only as a hash, so you sign in with your saved copy.
Can I use one account on several devices?
Yes. Sign in with the same token on as many browsers and devices as you like.
Can I have more than one account?
Yes, up to 3 accounts per network, for example one per project. Each account has its own credit and its own API keys.
How long is my data kept?
Message text and recipient numbers are deleted 90 days after sending. Totals, charges and your credit history stay on the account.
What happens if I lose my token?
The token is stored only as a hash, so it cannot be shown again or recovered. When you create the account, save it in a password manager or in the .txt file you download.
10 questions
Sending SMS
Which countries can I send to?
227 countries in 8 regions. Each country has a page with its price per SMS, number format and sample costs.
How many numbers can I send to at once?
Up to 10,000 numbers in one send from the web, and up to 1,000 per API request. Paste numbers or upload a CSV.
How should numbers be written?
In international form: a plus sign, the country code, then the number. 0044 instead of +44 also works, and spaces, brackets and dashes are removed automatically.
What happens to duplicates and wrong numbers?
They are left out before sending and shown with the reason. Only numbers that can be sent are charged.
Can each message be personal?
Yes. Add values after each number, separated by commas, and write {{1}}, {{2}} in the text. Each number gets its own filled-in message, and the parts are counted per number.
Can I schedule a campaign?
Yes, from 5 minutes to 29 days ahead. It is paid when you schedule it, and cancelling before it starts refunds it in full.
Can I add an opt-out line?
Yes. Choose it on the Send page and "Reply STOP to opt out" is added on a new line at the end, included in the part count.
What is the longest message I can send?
Up to 10 parts joined together: 1,530 GSM-7 characters, or 670 Unicode characters (for example Korean or emoji).
Can I send verification codes (OTP)?
Yes. Send to a single number right away through the API, and receive the delivery result for each number by webhook.
What kind of SMS can I send?
Messages to people who agreed to receive them. Marketing messages include an opt-out line. The full rules are in the acceptable use policy.
8 questions
Pricing and top-ups
Is there bonus credit?
Yes: first top-up only, +10% from $100, +15% from $200, +20% from $300, +25% from $500. The price per SMS is the same for every account.
Is there a monthly fee?
The monthly fee is $0. Subscription and setup fee are also $0, and only the messages you send are taken from your credit.
Does my credit expire?
Your credit has no expiry date. Top-ups are used for sending and are not withdrawn to a wallet; every refund goes back to your credit.
Where do I see my top-ups?
The Billing page lists every top-up with its status, and every credit change. Your credit updates as soon as a payment is credited.
What if I paid after the payment window closed?
The payment is still found. Write to Support with the top-up code and the transaction ID, and it is added to your credit by hand.
Which network should I use?
The network you choose in the checkout: TRON, BNB Chain, Ethereum, Solana, Polygon, Arbitrum or TON for USDT, BNB Chain, Ethereum, Solana, Polygon, Arbitrum or Base for USDC, and the coin's own network for BTC, ETH (Ethereum, Arbitrum or Base), BNB, POL, SOL, LTC, TRX, DOGE, TON and XRP. The checkout shows the network next to the address.
How much does it cost to send 1,000 SMS?
The country's price per SMS times 1,000. For a one-part message: United States $5.20, United Kingdom $8.10, Germany $15.00. Every country's price is on the pricing page.
What is the lowest SMS price?
From $0.0025 per SMS (Brazil, in US dollars). All 227 countries have a published price per SMS.
4 questions
Delivery results
How do I follow a campaign?
Every number moves from queued to sent, then to delivered or failed. The campaign page updates live, and the API and webhooks report the same statuses.
Why did my message use more parts than expected?
One character outside GSM-7, such as an emoji or a curly quote, switches the whole text to Unicode, where one part holds 70 characters. The Send page names the characters that caused it.
When is a failed message refunded?
As soon as the carrier reports it as failed. Each refund is one line per message in Billing.
Is there a limit per day?
Yes, each account can send up to 50,000 messages in 24 hours.
6 questions
Developer API
How do I get an API key?
Create one on the API keys page once your first top-up is credited. It is shown once, so copy it to your server right away.
Can I check the price without sending?
Yes. POST /api/v1/estimate takes the same body as sending and returns the parts, the cost and any numbers that would be left out.
How do delivery webhooks work?
Set an https address on the API keys page, and each delivered or failed message is sent there as JSON, signed with HMAC-SHA256. Until your server answers 2xx, it is sent up to 8 times including the first, over about 2 hours.
How many API calls can I make?
300 calls per minute per account, with up to 1,000 numbers in one request.
How do I check that a webhook came from PortSMS?
Check the HMAC-SHA256 signature in the X-PortSMS-Signature header. When the value computed over "t.body" with your webhook signing secret matches v1, the notification came from PortSMS.
Is there sample code?
The API reference has examples in curl, Node.js and Python.
Still have a question?
For anything else, ask in console Support once your first top-up is credited. The reply arrives on the same page.