Short Message Peer-to-Peer Set-up Guide

SMPP is great for customers that require a high throughput. Learn how to get it set up on your Telnyx account.

Telnyx Engineering avatar
Written by Telnyx Engineering
Updated over a week ago

SMPP Overview

The Short Message Peer-to-Peer Protocol is a widely used protocol for SMS delivery and receipt. SMPP is best utilized by customers that require high throughput. The following guide is designed to help you establish an SMPP bind and initiate your SMS campaigns. 

This feature is reserved for contracted Telnyx customers only. Please liaise with your account manager or sales rep for assistance on getting set up.

SMPP Hosts

Telnyx provides users a primary SMPP server, which must be connected with over TLS.  

SMPP Hosts value table.

In the future, Telnyx will offer both a primary and secondary server. Once available, Telnyx will only guarantee that one of the servers is up at anytime, and it will be highly recommended that customers connect to both in order to avoid service outages.  

Username and password

Your username and password will be provided by your Telnyx account manager. You can request one by providing the ID of the Messaging Profile you intend to utilize for SMPP messaging. You can find your Messaging Profile ID by navigating to Messaging, open settings for the messaging profile to be used (Basic, Inbound or Outbound), and the Messaging Profile ID will be at the bottom of the pop-up screen.  

Throughput per number

Throughput per number varies by number type.  Messages over Long Code numbers can be delivered at 10 messages per number per minute, while messages over toll-free can be delivered at 1200 message per number per minute.  

Binding - Supported PDUs

Telnyx supports the following PDUs

  • bind_transmitter

  • bind_transceiver

  • bind_receiver

  • unbind

  • submit_sm

  • deliver_sm

  • enquire_link

Binding - Required Parameters 

  • system_id = Telnyx provided

  • password = Telnyx provided

  • Host = smpp.telnyx.com

  • Port = 2775

  • SSL = yes

  • addr_ton = 1  (International)

  • addr_npi = 1 (ISDN/telephone numbering plan (E163/E164)

Did this answer your question?