This webhook sends you information about sent messages. You can use this webhook to save information about sent messages, such as message_id, gateway, timestamp, payload, etc.
JSON API (v2)
API for sending messages via SMS, Viber, WhatsApp and other communication channels.
API key is required for all requests. You can find your API key in your account settings.
API versions (http-api and xml-api) are deprecated also and you should use this JSON API v2 instead.
Download OpenAPI description
Overview
URL
E-mail
Languages
Servers
Mock server
https://api-ref.smsmanager.com/_mock/openapi/en/json/jsonapi_v2/
Responds with your request data
https://api.smsmngr.com/v2/
Bodyapplication/jsonrequiredArray [
Unique message identifier. (if you use /messages endpoint, then you will receive message_id with -<recipient_index> appended to the message_id).
Example: "e27ff0ac-87b5-4e1d-b644-5fc6029e2a11"
Used flow for the message.
Enum"sms""viber""whatsapp_text""whatsapp_template"
Example: "sms"
Result of the message sending. First, you will receive sent status, then another statuses will follow. If the message is rejected, that means that the message was not even sent (typical reason is insufficient credit or invalid phone number).
Enum"delivered""undelivered""rejected""failed""sending""sent""seen"
Additional result code for the message in format "[code] Description". Code is optional, description is also optional. Result info can also contain only code inside square brackets or only description without code.
- Mock server
https://api-ref.smsmanager.com/_mock/openapi/en/json/jsonapi_v2/sentMessage
- Responds with your request data
https://api.smsmngr.com/v2/sentMessage
application/json
[ { "request_id": "bc36f3d1-d284-463a-921b-a3560c154649", "message_id": "e27ff0ac-87b5-4e1d-b644-5fc6029e2a11", "gateway": "sms", "timestamp": 1700000000, "payload": { … }, "type": "outgoing", "to": { … }, "result": "delivered", "result_info": "[0] Delivered" } ]
Bodyapplication/jsonrequiredArray [
Unique request identifier used for sent message to the recipient.
Example: "bc36f3d1-d284-463a-921b-a3560c154649"
Unique message identifier used for sent message to the recipient.
Example: "e27ff0ac-87b5-4e1d-b644-5fc6029e2a11"
Used flow for the message. Note, that for whatsapp_body instead of whatsapp_template you will receive only whatsapp (incoming messages are not split into whatsapp_body or whatsapp_template).
Enum"sms""viber""whatsapp"
Timestamp of the message in Unix timestamp format. This is the timestamp of the message has been sent by the sender (if that infomration is not available, then you will receive timestamp of the message has been received by our system).
Example: 1700000000
Sender of the message. In some countries, the alphameric sender is not fully supported.
Example: "420777123456"
- Mock server
https://api-ref.smsmanager.com/_mock/openapi/en/json/jsonapi_v2/incomingReplyMessage
- Responds with your request data
https://api.smsmngr.com/v2/incomingReplyMessage
application/json
[ { "request_id": "bc36f3d1-d284-463a-921b-a3560c154649", "message_id": "e27ff0ac-87b5-4e1d-b644-5fc6029e2a11", "payload": { … }, "gateway": "sms", "timestamp": 1700000000, "type": "incoming", "sender": "420777123456", "recipient": "420777654321", "body": "Thank you!" } ]
Bodyapplication/jsonrequiredArray [
Timestamp of the message in Unix timestamp format. This is the timestamp of the message has been sent by the sender (if that information is not available, then you will receive timestamp of the message has been received by our system).
Example: 1700000000
Sender of the message. In some countries, the alphameric sender is not fully supported.
Example: "420777123456"
- Mock server
https://api-ref.smsmanager.com/_mock/openapi/en/json/jsonapi_v2/incomingMessage
- Responds with your request data
https://api.smsmngr.com/v2/incomingMessage
application/json
[ { "gateway": "whatsapp", "timestamp": 1700000000, "type": "incoming", "sender": "420777123456", "recipient": "420777654321", "body": "Hello, I have a question." } ]