Sending marketing messages
Marketing SMS messages, also known as promotional SMS, are text messages sent by businesses or marketers to a group of recipients with the aim of promoting products, services, offers, or events. These messages are typically designed to capture the attention of recipients, generate interest, and drive specific actions such as making a purchase, visiting a website, or participating in a promotional campaign.
Some sample use-cases for marketing SMS messages are:
-
Product launch or announcement:
Send SMS messages to your customer base to announce the launch of a new product or service.
-
Exclusive offers and discounts:
Send SMS messages to inform customers about exclusive deals, discounts, or limited-time promotions.
-
Event Invitations:
Send SMS invitations to customers or targeted segments for events, webinars, workshops, or conferences.
-
Loyalty programs and rewards:
Send SMS messages to loyal customers as part of a loyalty program, rewarding them with exclusive perks, discounts, or personalized offers.
-
Customer surveys and feedback requests:
Send SMS messages to gather customer feedback, conduct surveys, or request reviews. Offer incentives, such as discounts or loyalty points, to encourage participation.
These are just a few examples of how marketing SMS messages can be utilized. The key is to craft concise, compelling messages with clear call-to-actions, ensuring they provide value and resonate with your target audience.
Sending marketing messages through Falu
You can send marketing messages through Falu as follows:
- Step 1: Create a marketing messaging stream.
Create (or update) a marketing stream through which your promotional messages will be sent. As covered in Using message streams, marketing streams are designed to ensure optimal deliverability of messages.

You can create or update message streams using either the dashboard or messaging API.
For more information, check Using message streams.
- Step 2: Create a message batch using the marketing stream.
Since you are sending a message to more than one recipient, it would be best to send them as a message batch.
As covered in Working with message batches, the following API calls can be used to send a message batch using the marketing stream created in Step 1.
curl -X POST 'https://api.falu.io/v1/message_batches' \
--header 'Authorization: Bearer YOUR_SECRET_KEY \
--header 'X-Falu-Version: 2022-09-01' \
--header 'Content-Type: application/json' \
--data '{
"stream":"marketing-test",
"messages":[
{
"tos":["+254recipient1","+254recipient2",...],
"body":"YOUR_MESSAGE_BODY"
}
]
}'
Alternatively, if you wish to use an existing template:
curl -X POST 'https://api.falu.io/v1/message_batches' \
--header 'Authorization: Bearer YOUR_SECRET_KEY' \
--header 'X-Falu-Version: 2022-09-01' \
--header 'Content-Type: application/json' \
--data '{
"stream":"marketing-test",
"messages":[
{
"tos":["+254recipient1","+254recipient2",...],
"template":{
"id":"TEMPLATE_ID",
"model":{
"key":"value"
}
}
}
]
}'
Archive or delete a marketing stream
You can delete or archive a marketing stream that is no longer needed using the Delete Message Stream API or Archive Message Stream API, respectively.
For example, we delete the marketing message stream we created in Step 1 above as:
curl --location --request DELETE 'https://api.falu.io/v1/message_streams/mstr_2sH9A4pzMcS2ZRgLLTKCk0eeTH5' \
--header 'X-Falu-Version: 2022-09-01' \
--header 'Authorization: Bearer MY_SECRET_KEY'