Add custom routes

A custom route connects your own SMS provider to the platform. You then send through your route with all the platform tools: lists, segments, tracked links, reports and testing. You can use custom routes together with our routes.

We charge a platform fee for each SMS that you send through a custom route. The standard fee is €0.01 per SMS. You pay your provider for the messages directly.

If you do not see Custom Routes in the Routes menu, ask your account manager to turn on the feature for your account.

Add a custom route

  1. Go to Routes > Custom Routes.
  2. Click Add Route.
  3. Type a Name for the route.
  4. Select the Connection Type: SMPP or HTTP API.
  5. Fill in the connection fields (see below).
  6. Click Create.

SMPP connection

  • Host and Port of the SMPP server of your provider (for example smpp.provider.com and 2775).
  • Username and Password of your SMPP account.
  • Bind Mode: keep Transmitter (TX) unless your provider asks for Transceiver (TRX). We collect delivery reports on a separate receiver connection in both modes.

Ask your provider to whitelist our IP address 116.202.73.92 on their SMPP server. Without this, the connection fails.

Click Test Connection to check the connection before you save.

HTTP API connection

  • API URL: the send URL of your provider. Use these placeholders: {{{from}}} (sender ID), {{{number}}} (recipient) and {{{text}}} (message). Example:
    https://api.provider.com/sms?from={{{from}}}&to={{{number}}}&text={{{text}}}
  • Username and Password, if your provider uses them.
  • Use POST method: select this if your provider expects a POST request.
  • Custom Headers: click + Add Header to add a header, for example an API key header.

Add prices

A route sends only to countries that have a price. The route list shows No pricing until you add one. Enter the price that your provider charges you per SMS. We use it to show the full cost of your campaigns.

  1. On the row of the route, click the Pricing icon.
  2. Click the Add Price tab.
  3. In Country, type the country ID, ISO code or name (for example GB).
  4. In Price (EUR), type the price per SMS.
  5. Click Add Price.

To add many countries at once, use the Bulk Upload tab. Type one country and price on each line:

US,0.01
GB,0.02
DE,0.015

The Prices tab shows all the prices of the route. Use the delete icon to remove a price.

Send a test SMS

Before you send a campaign, make sure that the route works.

  1. On the row of the route, click the Test SMS icon.
  2. Type the sender ID in From (Sender ID).
  3. Type your phone number in To (Phone Number).
  4. Change the Message if necessary.
  5. Click Send Test.

To compare your route with other routes on real test phones, read Test routes before you send.

Send a campaign through a custom route

  1. Open your campaign.
  2. Click the Routes field.
  3. Select your custom route.

Choose how the platform picks routes

The Routing Configuration tab controls how the platform chooses between your custom routes and our routes.

Under Default routing strategy, select one option:

OptionWhat it does
Custom routes firstUses your routes first. If none of your routes covers the country, it uses a platform route.
BlendedYour routes and platform routes compete equally. The route with the best score and priority wins.
Platform routes firstUses platform routes first. It uses your routes only for countries that no platform route covers.

Under Per-country exceptions, you can change the strategy for one country. Expand the country to see its routes and their performance. Then set the route order, turn routes off, or lock one route. An exception applies to that country only.

Monitor your routes

The Stats tab shows the Sending Statistics, an SMS Log and the SMPP Connection History of your routes. Use it to find failed messages and connection problems.

On the Routes tab, use the switch on a row to turn a route on or off. Use the edit icon to change the connection, and the delete icon to remove the route.

Need more help? Contact support.