How to send SMS messages with Sinch

Setup guide for SMS notifications with Sinch and Knock.

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

Features

Per environment configuration
Delivery tracking
Knock link tracking
Sandbox mode

Getting started

You can create a new Sinch 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

The following channel settings should be configured per environment. Navigate to Channels and sources in your dashboard account settings, select your Sinch channel, then click "Manage configuration" under the environment that you'd like to configure.

Fields marked with an * are required.

Knock settings

Sandbox modeboolean

Whether to enable sandbox mode for your Sinch channel.

Knock link trackingboolean

Whether to enable Knock link-click tracking.

Provider settings for Sinch

API tokenstring*

The API token from Sinch.

Service Plan IDstring*

The Service Plan ID from Sinch.

Regionenum*

The region of your domain. One of AU, BR, CA, EU, US.

Fromenum

The method used to send your SMS messages. One of Phone number, Short code, or Sender ID. Optional if you have an automatic originator number on your Sinch account.

Phone numberstring*

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

Short codestring*

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

Sender IDstring*

The Sinch Sender ID to send messages from. Required when From is set to Sender ID.

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.