Skip to content

Gateway setup

Connect your SMS gateway

Ultra SMS sends through the gateway account you already have. Each guide says which values the app asks for, where to find them, and what to check before your first campaign.

Before you connect a gateway

Ultra SMS does not sell SMS credit

You pay your gateway for each message segment at its own rates. Ultra SMS only sends through the account you connect, so you keep your prices and your sender IDs.

Numbers in international format

Gateways expect E.164 numbers: a plus sign, the country code and the number, for example +14155550123 or +919812345678. Ultra SMS cleans imported numbers into this format.

Sender IDs depend on the country

Some countries allow a name (an alphanumeric sender ID), some need a registered number, and the USA and Canada need a registered 10DLC, toll-free or short code number.

India needs DLT

Commercial SMS to Indian numbers must carry your DLT Entity ID and the Template ID of an approved template, from an approved sender ID (header). Promotional SMS is only delivered in the daytime window TRAI allows (it ends at 9 pm; your gateway states the exact start time).

Use more than one gateway

Add several gateways and Ultra SMS rotates between them; a failed message is retried on the next gateway.

Test first

Every gateway window has Test credentials, which checks the login and sends nothing, and Send test SMS. Send one message to your own phone before you trust a gateway with a campaign.

Global gateways

When the test fails

Authentication failed / 401

The key, token or password is wrong, or belongs to a different account or region. Copy it again from the dashboard, without spaces.

Number not verified (trial account)

Trial accounts only send to numbers you verified. Add credit or upgrade the account to send to anyone.

Sender ID not allowed

The destination country does not accept that sender. Use a registered number, or register the sender ID with the gateway.

DLT template mismatch (India)

The text must match the approved template exactly, with only the {#var#} parts changed. Check the Template ID, the sender ID and every space and punctuation mark.

Invalid number

The number is not in international format or has the wrong length. Run the list through the number validator.

Insufficient balance

Top up the gateway account. Ultra SMS cannot send on credit you do not have.

Too many requests / 429

You are sending faster than the gateway allows. Lower Max per minute in Settings or on that gateway.

Accepted but never delivered

Operators can filter messages without telling the gateway. Check the delivery report, the sender registration (10DLC or DLT) and the content for links or words that trigger filters.

Ultra SMS is not affiliated with any SMS gateway named on this site. Gateway names are trademarks of their owners.