This is the API V2 documentation. To switch out of beta revert back to our API V1.

Open SidemenuDocs
Docs
Close Sidemenu
Choose:
cURLPythonRubyNodePHP
cURLPythonRubyNodePHP

Alphanumeric Sender IDalphanumeric-sender-id

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 endpointAPIuse-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.

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

Was this page helpful?was-this-page-helpful