Quick guide on how to start the API

With Masiv's SMS Campaigns API, any company will be able to connect to our messaging platform through the software it manages and send bulk SMS campaigns.

With an easy and straightforward integration, all companies will be able to manage their SMS communications in their existing applications.

To create a campaign and send it, three steps must be followed in order, the first step is to create the campaign with the basic configuration information, the second step is to load the recipients to which the campaign will be sent, and the third and final step is to close the campaign or mark it as “Ready to send”, the specification of each of these steps is specified below.

Important information for sending SMS

Type of message

Standard: Traditional text message that is saved in the phone's inbox as plain text. This is the most common type of SMS.
Instant: Also known as Flash SMS. When delivered, it appears directly on the phone's screen, temporarily locking it. It disappears when any key is pressed and is not stored in the inbox. It does not allow user interaction. Important: This type of message is not available in all countries, so it is recommended to validate it before sending.

Message format

Short: Up to 160 characters, equivalent to 1 message. Special characters are not allowed.
Long: Up to 1,000 characters, equivalent to a maximum of 7 messages. Every 153 characters is counted as one message. Although it is divided internally, the recipient receives it as a single message. Special characters are not supported. Note: Marking a message as long does not mean that it must exceed 160 characters, but allows you to do so if necessary.
Rich text: Allows emojis and special characters. Up to 1,000 characters, equivalent to a maximum of 16 messages. In this case, every 63 characters are counted as one message. Like the long format, the recipient receives it as a single message.

Postman collection

MasivSmsCampaignApi.postman_collection.json

Authentication

All SMS Campaigns API endpoints require authentication. For this purpose, it is necessary to include a Basic Authentication header corresponding to a valid Masiv user in each of the requests made.

Header name	Value	Description	Mandatory
Authorization	Basic Token	Basic Auth type authentication header, the token must contain the following structure user:password base 64 encoded and correspond to a valid Masiv user.	Required

Campaign creation

To create a campaign, a POST request must be made to the endpoint specified for this purpose, including the authentication data and a JSON Body containing all the data or configuration attributes of the campaign to be created.