Send SMS API

📄 API Documentation: International SMS Sending

Overview

This API allows you to send international SMS messages via the Your Domain (pingtochat.com) service. It is useful for businesses looking to reach users across different countries with messages such as alerts, notifications, OTPs, or promotional content.

URL

http://{{your_domain}}/api/v1.0/{{key}}/Internationalsms

Method

POST

Headers

• Content-Type: application/json
• Authorization: Bearer <your_access_token>

Request PayloadsYour Domain (pingtochat.com)

Sending a Text Message

The payload for sending a plain text message via the WhatsApp API is structured as follows:

Example :

{
  "messaging_product": "sms",
  "to": "91 xxxxxxxxxx",
  "from": "TWILIO",
  "message": "test message",
  "templateId":6,
  "bulkId":1
}

Field description

Field	Type	Description
messaging_product	string	Type of messaging product (must be "sms" for SMS sending).
to	string	Recipient’s mobile number in international format. E.g., "91xxxxxxxxxx".
from	string	Sender name or ID (e.g., "TWILIO").
message	string	Message content to be sent.
templateId	int	ID of the predefined message template (if applicable).
bulkId	int	ID for grouping multiple messages as a bulk operation.

✅ Success Response

HTTP 200 OK

{
    "status": "success",
    "messaging_product": "sms",
    "bulk_id": 1,
    "contacts": [
        {
            "phone_number": "+91xxxxxxxxxx",
            "status": "sent"
        }
    ],
    "messages": [
        {
            "transaction_id": "ABCDEFGHIJ"
        }
    ]
}

❌ Error Responses

HTTP Status	Meaning	Sample Error Message
400	Bad Request	"Invalid phone number format"
401	Unauthorized	"Invalid API key"
403	Forbidden	"Access denied"
500	Internal Server Error	"Unexpected error occurred. Try again later"