SMS API

Automation and critical notifications

The SMS API section enables full integration of your software with the MessageFlow infrastructure. This solution handles transactional traffic, such as OTP codes and order statuses, and executes automated communication scenarios directly from your code.

Key API capabilities

• Full dashboard visibility: API operations are not a "black box." All outgoing and incoming messages processed via integration are visible in the dashboard interface, just like standard campaigns.

  • Benefit: Your Customer Service department can independently verify if an SMS with a code reached the user without involving developers or searching through server logs.

• Direct Connections (Enterprise Quality): The platform uses direct, certified connections with mobile operators. This guarantees the highest deliverability and eliminates the risk of grey routing.

• MessageFlow Priority (Add-on): Use a dedicated, separate infrastructure for time-critical messages such as 2FA codes, banking alerts, or password resets. The system processes these notifications outside the standard bulk marketing queue. Note that this service is an optional paid module. Find more information in the MessageFlow Priority section.

• Webhooks and Reporting (DLR): Your system receives feedback in real time. Configure a webhookUrl to automatically receive delivery statuses (Delivered, Undelivered, Expired) directly into your database.

• Two-way messaging (2-Way): The API supports receiving incoming messages on dedicated numbers (Short Codes or Long Numbers). This allows you to build interactive SMS bots.

Developer Experience (DX)

The platform aims to minimize integration time.

• Standard: RESTful API based on a transparent JSON format.

• Code Snippets: Access ready-to-use "copy-paste" fragments for popular languages, including Shell (cURL), Python, PHP, Java, C#, Node.js, Go, Ruby, and Swift.

How it works

Communication occurs via secure HTTPS requests.

• Method: POST

• Endpoint: https://api.messageflow.com/v2.1/sms

• Authentication: Use the required Application-Key and Authorization headers. You can generate tokens in the Account > API tab.

Example Payload (JSON): Send the message content, recipients, and optional parameters in the request.

{
  "sender": "YourCompany",
  "message": "Your authorization code is: 1234",
  "phoneNumbers": [
    "48111222333"
  ],
  "priority": true
}

(The above code is a simplified example. Find the full structure in the API documentation.)

Best Practice: OTP Codes

Are you sending one-time passwords? Use the MessageFlow Priority add-on. This ensures the platform processes the request immediately without waiting in the marketing message queue.

Developer Documentation

Find a detailed description of all methods, error codes, and a full list of parameters in the developer portal:

Go to MessageFlow API Docs >>