How to send SMS messages with Telnyx

Get started sending SMS notifications with Telnyx and Knock.

Knock integrates with Telnyx to send SMS notifications to your recipients.

Features

Delivery tracking
Knock link tracking
Per environment configuration
Sandbox mode
Number Pool messaging

Getting started

You can create a new Telnyx channel in the dashboard under the Channels and sources page in your account settings. From there, you'll need to configure the channel for each environment you have.

Channel configuration

Configure the following settings per environment. Navigate to Channels and sources in your dashboard account settings and select your Telnyx channel. Under Environment configurations, click the environment you'd like to configure to expand its settings, then click "Save changes" when you're done. Expand Advanced for additional options, including overrides and conditions.

Fields marked with an * are required.

API keystring*

The API key from Telnyx.

Fromenum*

The method used to send your SMS messages. One of Phone number, Short code, Sender ID, or Messaging Profile ID. Choose Messaging Profile ID to send from a Telnyx Number Pool, where Telnyx selects the sending number from the profile.

Phone numberstring*

The phone number to send messages from. Required when From is set to Phone number.

Short codestring*

The Telnyx short code to send messages from. Required when From is set to Short code.

Sender IDstring*

The alphanumeric Telnyx Sender ID to send messages from. Required when From is set to Sender ID, along with the Messaging Profile ID the Sender ID is configured on. Note that alphanumeric sender IDs can't send to the US, Canada, or Puerto Rico.

Messaging Profile IDstring*

The Telnyx Messaging Profile ID. Required when From is set to Messaging Profile ID (Number Pool messaging) or Sender ID (the profile your Sender ID is configured on).

Sandbox modeboolean

Whether to enable sandbox mode for your Telnyx channel.

Link trackingboolean

Whether to enable Knock link-click tracking.

When configured, the optional payload overrides set here will apply to all SMS notifications sent from this channel in the configured environment. Learn more about SMS channel overrides here.

Payload overridesJSON (string) | liquid

Provide a JSON object to merge into the API payload that is sent to the downstream provider.

Set optional per-environment conditions for this channel. These conditions are evaluated each time a workflow run encounters a step that uses this channel in the configured environment. If the conditions are not met, the step will be skipped.

Recipient data requirements

In order to send an SMS notification you'll need a valid phone_number property set on your recipient.