TeleSign is a cloud communications platform helping the world’s leading websites and mobile applications across SMS messaging, voice messaging, mobile app verification and phone intelligence.

Using TeleSign Example and Walkthrough

For this example, we’ll configure the Braze webhook channel to send SMS to your users, via TeleSign’s SMS API.

To use TeleSign’s SMS web service to send a request, you’ll need to use the following Webhook URL when composing a webhook in Braze:


Step 1: Set Up Your Request Body

The TeleSign API expects the request body to be URL-encoded, so you must change the request type in the Braze Webhook composer to Raw Text. The required parameters for the body of the request are Phone Number (phone_number), Message (message), and Message Type (message_type). You’ll need to have valid phone numbers on each user profile in your target audience. TeleSign defines a valid phone number as the end user’s phone number with country code included.


The image below depicts an example of what your request might look like if you are sending an SMS to each user’s phone number, with the body “Hello from Braze!”.

Step 2: Compose Request Headers and HTTP Method

TeleSign requires two request headers, the request Content-Type and an HTTP Basic Authentication header.


Add these to your webhook by clicking the gear icon on the right side of the Webhook composer, then clicking Add New Pair twice.

When you add them to your webhook, be sure to replace TELESIGN_CUSTOMER_ID and TELESIGN_API_KEY in the Header Values with values from your TeleSign dashboard. Lastly, TeleSign’s API endpoint expects an HTTP POST request, so choose that option in the dropdown for HTTP Method.


Step 3: Preview Your Request

Use the Webhook composer to preview the request for a random user, or for a user with particular credentials, to ensure that the request is rendering properly.


Make adjustments as needed, and be sure to save your template! Happy messaging!

New Stuff!