Send flash SMS

POST 
https://core-prod.malipopay.co.tz/api/v1/sms/flash

Send a flash (class 0) SMS — appears directly on the recipient's screen without being saved. Useful for OTPs and urgent alerts.

Request

application/json

Body

Bodyrequired

senderstringrequired
Sender ID
Example: MALIPOPAY
phoneNumberstringrequired
Recipient phone number
Example: 255742200105
messagestringrequired
Message content
Example: Hello from MalipoPay!

Example (auto)

{
  "sender": "MALIPOPAY",
  "phoneNumber": "255742200105",
  "message": "Hello from MalipoPay!"
}

Responses

201

Flash SMS queued successfully

application/json

Schema

Schema

successboolean
Example: true
codeinteger
Example: 2000
messagestring
Example: SMS sent successfully
dataobject

SMS result data

Example (auto)

{
  "success": true,
  "code": 2000,
  "message": "SMS sent successfully",
  "data": {}
}

400

Validation error

application/json

Schema

Schema

successboolean
Example: false
codeinteger
Example: 5001
messagestring
Example: Template operation failed

Example (auto)

{
  "success": false,
  "code": 5001,
  "message": "Template operation failed"
}

401

Unauthorized (invalid apiToken)

application/json

Schema

Schema

successboolean
Example: false
codeinteger
Example: 5001
messagestring
Example: Template operation failed

Example (auto)

{
  "success": false,
  "code": 5001,
  "message": "Template operation failed"
}

500

Internal server error

application/json

Schema

Schema

successboolean
Example: false
codeinteger
Example: 5001
messagestring
Example: Template operation failed

Example (auto)

{
  "success": false,
  "code": 5001,
  "message": "Template operation failed"
}

Authorization: apiToken

name: apiTokentype: apiKeyin: headerdescription: Project API key. Get yours from the Malipopay dashboard under Settings → API Keys.

• curl
• python
• nodejs
• php
• java
• go

• CURL

curl -L 'https://core-prod.malipopay.co.tz/api/v1/sms/flash' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'apiToken: <apiToken>' \
-d '{
  "sender": "MALIPOPAY",
  "phoneNumber": "255742200105",
  "message": "Hello from MalipoPay!"
}'

Request

Base URL

https://core-prod.malipopay.co.tz

Auth

apiToken

Body required

{
  "sender": "MALIPOPAY",
  "phoneNumber": "255742200105",
  "message": "Hello from MalipoPay!"
}

Response

Click the Send API Request button above and see the response here!