Skip to main content
| cURL | Python | PHP | Node | Java | .NET | Ruby |

​
cURL

An Alphanumeric Sender ID lets you send messages using a custom ID constructed from a combination of alpha (a-z, A-Z) and numeric (0-9) characters as well as spaces. This makes the sender identifiable to the receiver, as companies can set their brand name as the ID (e.g., TELNYX). It’s commonly used for sending one-way text messages, as the person receiving the message will be unable to reply with an Alphanumeric Sender ID.
Each country regulates alphanumeric sender ID differently. Ensure that you’re complying with the local regulations.
Use the send message endpoint Instead of specifying a phone number as the “From” field, provide the Alphanumeric Sender ID. You will also need to specify the Messaging Profile (via the messaging_profile_id parameter) that will be used to send the message.
Telnyx attempts to deliver your message whenever possible. If you use a sending number that is unable to deliver the message, Telnyx will failover to using an generic alphanumeric sender ID to terminate the message.
curl -X POST \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --data '{
    "from": "Telnyx",
    "to": "+13115552367",
    "text": "Hello, world!",
    "messaging_profile_id": "YOUR_MESSAGING_PROFILE_ID"
  }' \
  https://api.telnyx.com/v2/messages
After pasting the above content, Kindly check and remove any new line added

​
Using Python for Alphanumeric Sender IDs

An Alphanumeric Sender ID lets you send messages using a custom ID constructed from a combination of alpha (a-z, A-Z) and numeric (0-9) characters as well as spaces. This makes the sender identifiable to the receiver, as companies can set their brand name as the ID (e.g., TELNYX). It’s commonly used for sending one-way text messages, as the person receiving the message will be unable to reply with an Alphanumeric Sender ID.
Each country regulates alphanumeric sender ID differently. Ensure that you’re complying with the local regulations.
When sending messages, use the send message endpoint. Instead of specifying a phone number as the “From” field, provide the Alphanumeric Sender ID. You will also need to specify the Messaging Profile (via the messaging_profile_id parameter) that will be used to send the message.
Telnyx attempts to deliver your message whenever possible. If you use a sending number that is unable to deliver the message, Telnyx will failover to using an generic alphanumeric sender ID to terminate the message.
import telnyx

telnyx.api_key = "YOUR_API_KEY"

destination_number = "+13115552367"

telnyx.Message.create(
    from_="Telnyx",
    to=destination_number,
    text="Hello, world!",
    messaging_profile_id="YOUR_MESSAGING_PROFILE_ID",
)
After pasting the above content, Kindly check and remove any new line added

​
PHP for Alphanumeric Sender IDs

An Alphanumeric Sender ID lets you send messages using a custom ID constructed from a combination of alpha (a-z, A-Z) and numeric (0-9) characters as well as spaces. This makes the sender identifiable to the receiver, as companies can set their brand name as the ID (e.g., TELNYX). It’s commonly used for sending one-way text messages, as the person receiving the message will be unable to reply with an Alphanumeric Sender ID.
Each country regulates alphanumeric sender ID differently. Ensure that you’re complying with the local regulations.
When sending messages, use the send message endpoint. Instead of specifying a phone number as the “From” field, provide the Alphanumeric Sender ID. You will also need to specify the Messaging Profile (via the messaging_profile_id parameter) that will be used to send the message.
Telnyx attempts to deliver your message whenever possible. If you use a sending number that is unable to deliver the message, Telnyx will failover to using an generic alphanumeric sender ID to terminate the message.
\Telnyx\Telnyx::setApiKey('YOUR_API_KEY');

\Telnyx\Message::Create([
  "from" => "Telnyx",
  "to" => "+18445552367",
  "text" => "Hello, World!",
  "messaging_profile_id" => "YOUR_MESSAGING_PROFILE_ID"
]);
After pasting the above content, Kindly check and remove any new line added

​
Node for Alphanumeric Sender IDs

An Alphanumeric Sender ID lets you send messages using a custom ID constructed from a combination of alpha (a-z, A-Z) and numeric (0-9) characters as well as spaces. This makes the sender identifiable to the receiver, as companies can set their brand name as the ID (e.g., TELNYX). It’s commonly used for sending one-way text messages, as the person receiving the message will be unable to reply with an Alphanumeric Sender ID.
Each country regulates alphanumeric sender ID differently. Ensure that you’re complying with the local regulations.
When sending messages, use the send message endpoint. Instead of specifying a phone number as the “From” field, provide the Alphanumeric Sender ID. You will also need to specify the Messaging Profile (via the messaging_profile_id parameter) that will be used to send the message.
Telnyx attempts to deliver your message whenever possible. If you use a sending number that is unable to deliver the message, Telnyx will failover to using an generic alphanumeric sender ID to terminate the message.
import Telnyx from 'telnyx';

const telnyx = new Telnyx("YOUR_API_KEY");

telnyx.messages.create(
  {
    from: "Telnyx",
    to: "+18445552367",
    text: "Hello, World!",
    messaging_profile_id: "YOUR_MESSAGING_PROFILE_ID",
  },
  function (err, response) {
    // asynchronously called
    console.log(response);
  }
);
After pasting the above content, Kindly check and remove any new line added

​
Java for Alphanumeric Sender IDs

An Alphanumeric Sender ID lets you send messages using a custom ID constructed from a combination of alpha (a-z, A-Z) and numeric (0-9) characters as well as spaces. This makes the sender identifiable to the receiver, as companies can set their brand name as the ID (e.g., TELNYX). It’s commonly used for sending one-way text messages, as the person receiving the message will be unable to reply with an Alphanumeric Sender ID. Note: Each country regulates alphanumeric sender ID differently. Ensure that you’re complying with the local regulations. Use the send message endpoint Instead of specifying a phone number as the “From” field, provide the Alphanumeric Sender ID. You will also need to specify the Messaging Profile (via the messaging_profile_id parameter) that will be used to send the message. Note: Telnyx attempts to deliver your message whenever possible. If you use a sending number that is unable to deliver the message, Telnyx will failover to using an generic alphanumeric sender ID to terminate the message. 
import java.util.Arrays;
import com.telnyx.sdk.ApiClient;
import com.telnyx.sdk.ApiException;
import com.telnyx.sdk.Configuration;
import com.telnyx.sdk.auth.*;
import com.telnyx.sdk.model.*;
import com.telnyx.sdk.api.MessagesApi;

public class Example {
    //Alpha sender ID
    private static final String YOUR_ALPHA_SENDER_ID = "Telnyx";
    private static final String YOUR_MOBILE_NUMBER = "+19198675309";
    private static final String YOUR_TELNYX_API_KEY = "YOUR_API_KEY";

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api.telnyx.com/v2");

        // Configure HTTP bearer authorization: bearerAuth
        HttpBearerAuth bearerAuth = (HttpBearerAuth) defaultClient.getAuthentication("bearerAuth");
        bearerAuth.setBearerToken(YOUR_TELNYX_API_KEY);

        MessagesApi apiInstance = new MessagesApi(defaultClient);
         // CreateMessageRequest | Message payload
        CreateMessageRequest createMessageRequest = new CreateMessageRequest()
                .from(YOUR_ALPHA_SENDER_ID)
                .to(YOUR_MOBILE_NUMBER)
                .text("Hello From Telnyx");
        try {
            MessageResponse result = apiInstance.createMessage(createMessageRequest);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling MessagesApi#createMessage");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}
After pasting the above content, Kindly check and remove any new line added

​
.NET for Alphanumeric Sender IDs

An Alphanumeric Sender ID lets you send messages using a custom ID constructed from a combination of alpha (a-z, A-Z) and numeric (0-9) characters as well as spaces. This makes the sender identifiable to the receiver, as companies can set their brand name as the ID (e.g., TELNYX). It’s commonly used for sending one-way text messages, as the person receiving the message will be unable to reply with an Alphanumeric Sender ID. Note: Each country regulates alphanumeric sender ID differently. Ensure that you’re complying with the local regulations. Use the send message endpoint Instead of specifying a phone number as the “From” field, provide the Alphanumeric Sender ID. You will also need to specify the Messaging Profile (via the messaging_profile_id parameter) that will be used to send the message. Note: Telnyx attempts to deliver your message whenever possible. If you use a sending number that is unable to deliver the message, Telnyx will failover to using an generic alphanumeric sender ID to terminate the message. 
using System;
using Telnyx;
using System.Threading.Tasks;

namespace send_alpha_numeric_sms
{
  class Program
  {
    private static string TELNYX_API_KEY = System.Environment.GetEnvironmentVariable("TELNYX_API_KEY");
    private static string alphaSenderID = "Telnyx"; //Alphanumeric Sedner ID input
    private static string destinationNumber = "+19198675309";

    static async Task Main(string[] args)
    {
      Console.WriteLine("Hello World!");
      TelnyxConfiguration.SetApiKey(TELNYX_API_KEY);
      MessagingSenderIdService service = new MessagingSenderIdService();
      NewMessagingSenderId options = new NewMessagingSenderId
      {
        From = alphaSenderID,
        To = destinationNumber,
        Text = "Hello, World!"
      };
      try
      {
        MessagingSenderId messageResponse = await service.CreateAsync(options);
        Console.WriteLine(messageResponse.Id);

      }
      catch (Exception e)
      {
        Console.WriteLine(e.Message);
      }
    }
  }
}
After pasting the above content, Kindly check and remove any new line added

​
Ruby for Alphanumeric Sender IDs

An Alphanumeric Sender ID lets you send messages using a custom ID constructed from a combination of alpha (a-z, A-Z) and numeric (0-9) characters as well as spaces. This makes the sender identifiable to the receiver, as companies can set their brand name as the ID (e.g., TELNYX). It’s commonly used for sending one-way text messages, as the person receiving the message will be unable to reply with an Alphanumeric Sender ID.
Each country regulates alphanumeric sender ID differently. Ensure that you’re complying with the local regulations.
When sending messages, use the send message endpoint. Instead of specifying a phone number as the “From” field, provide the Alphanumeric Sender ID. You will also need to specify the Messaging Profile (via the messaging_profile_id parameter) that will be used to send the message.
Telnyx attempts to deliver your message whenever possible. If you use a sending number that is unable to deliver the message, Telnyx will failover to using an generic alphanumeric sender ID to terminate the message.
require "telnyx"

Telnyx.api_key = "YOUR_API_KEY"

to_number = "DESTINATION_NUMBER"

response = Telnyx::Message.create(
    from: "Telnyx",
    to: to_number,
    text: "Hello, world!",
    messaging_profile_id: "YOUR_MESSAGING_PROFILE_ID"
)
After pasting the above content, Kindly check and remove any new line added