WhatsApp API

OAuth 2.0 API Endpoint

https://sms.infopromo.digital/api/v3/

HTTP API Endpoint

https://sms.infopromo.digital/api/http/

Your API Token

{Obtain it from your SMS portal}

Note that our platform leverages the Official WhatsApp API from Meta to send WhatsApp messages; your WhatsApp sending number needs to be registered with us.

Alternatively, you can find all the FREE APIs in the developer section of our various portals after a FREE account opening.

WhatsApp API

Infopromo Communications – Bulk SMS Marketing SMS API allows you to send and receive SMS messages to and from any country in the world through a REST API. Each message is identified by a unique random ID so that users can always check the status of a message using the given endpoint.

API Endpoint

Markup
https://sms.infopromo.digital/api/v3/sms/send
Parameters
ParameterRequiredDescription
Authorization
Yes
When calling our API, send your api token with the authentication type set as Bearer (Example: Authorization: Bearer {your api_token})
Accept
Yes
Set to application/json
Send outbound SMS

Infopromo Communications – Bulk SMS Marketing’s Programmable SMS API enables you to programmatically send SMS messages from your web application. First, you need to create a new message object. Infopromo Communications – Bulk SMS Marketing returns the created message object with each request.

Send your first SMS message with this example request.

API Endpoint

Markup
https://sms.infopromo.digital/api/v3/sms/send
Parameters
ParameterRequiredTypeDescription
recipient
Yes
stringNumber to send message
sender_id
Yes
stringThe sender of the message. This can be a telephone number (including country code) or an alphanumeric string. In case of an alphanumeric string, the maximum length is 11 characters.
type
Yes
stringThe type of the message. For text message you have to insert whatsapp as sms type.
message
Yes
stringThe body of the SMS message.
media_url
No
urlURL’s of attachment of the MMS message. Supported media types: image/*
schedule_time
No
datetimeThe scheduled date and time of the message in RFC3339 format (Y-m-d H:i)
Example request
PHP
curl -X POST https://sms.infopromo.digital/api/v3/sms/send \
-H 'Authorization: Bearer {your api_token}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"recipient":"31612345678",
"sender_id":"YourName",
"type":"whatsapp",
"message":"This is a test message"
}'
Returns

Returns a contact object if the request was successful.

JSON
{
    "status": "success",
    "data": "sms reports with all details",
}

If the request failed, an error object will be returned.

JSON
{
    "status": "error",
    "message" : "A human-readable description of the error."
}
View an SMS

You can use Infopromo Communications – Bulk SMS Marketing’s SMS API to retrieve information of an existing inbound or outbound SMS message.

You only need to supply the unique message ID that was returned upon creation or receiving.

API Endpoint

Markup
https://sms.infopromo.digital/api/v3/sms/{uid}
Parameters
ParameterRequiredTypeDescription
uid
Yes
stringA unique random uid which is created on the Infopromo Communications – Bulk SMS Marketing platform and is returned upon creation of the object.
Example request
PHP
curl -X GET https://sms.infopromo.digital/api/v3/sms/606812e63f78b \
-H 'Authorization: Bearer {your api_token}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
Returns

Returns a contact object if the request was successful.

JSON
{
    "status": "success",
    "data": "sms data with all details",
}

If the request failed, an error object will be returned.

JSON
{
    "status": "error",
    "message" : "A human-readable description of the error."
}
View all messages

API Endpoint

Markup
https://sms.infopromo.digital/api/v3/sms/
Example request
PHP
curl -X GET https://sms.infopromo.digital/api/v3/sms \
-H 'Authorization: Bearer {your api_token}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
Returns

Returns a contact object if the request was successful.

JSON
{
    "status": "success",
    "data": "sms reports with pagination",
}

If the request failed, an error object will be returned.

JSON
{
    "status": "error",
    "message" : "A human-readable description of the error."
}
WhatsApp API

Infopromo Communications – Bulk SMS Marketing SMS API allows you to send and receive SMS messages to and from any country in the world through a REST API. Each message is identified by a unique random ID so that users can always check the status of a message using the given endpoint.

API Endpoint

Markup
https://sms.infopromo.digital/api/http/sms/send
Parameters
ParameterRequiredDescription
api_token
Yes
API Token From Developers option. Get API Token
Accept
Yes
Set to application/json
Content-Type
Yes
Set to application/json
Send outbound SMS

Infopromo Communications – Bulk SMS Marketing’s Programmable SMS API enables you to programmatically send SMS messages from your web application. First, you need to create a new message object. Infopromo Communications – Bulk SMS Marketing returns the created message object with each request.

Send your first SMS message with this example request.

API Endpoint

Markup
https://sms.infopromo.digital/api/http/sms/send
Parameters
ParameterRequiredTypeDescription
recipient
Yes
stringNumber to send message
sender_id
Yes
stringThe sender of the message. This can be a telephone number (including country code) or an alphanumeric string. In case of an alphanumeric string, the maximum length is 11 characters.
type
Yes
stringThe type of the message. For text message you have to insert whatsapp as sms type.
message
Yes
stringThe body of the SMS message.
media_url
No
urlURL’s of attachment of the MMS message. Supported media types: image/*
schedule_time
No
datetimeThe scheduled date and time of the message in RFC3339 format (Y-m-d H:i)
Example request
PHP
curl -X POST https://sms.infopromo.digital/api/http/sms/send \
-d '{
"api_token":"{your api_token}",
"recipient":"31612345678",
"sender_id":"YourName",
"type":"whatsapp",
"message":"This is a test message"
}
'
Returns

Returns a contact object if the request was successful.

JSON
{
    "status": "success",
    "data": "sms reports with all details",
}

If the request failed, an error object will be returned.

JSON
{
    "status": "error",
    "message" : "A human-readable description of the error."
}
View an SMS

You can use Infopromo Communications – Bulk SMS Marketing’s SMS API to retrieve information of an existing inbound or outbound SMS message.

You only need to supply the unique message id that was returned upon creation or receiving.

API Endpoint

Markup
https://sms.infopromo.digital/api/v3/sms/{uid}
Parameters
ParameterRequiredTypeDescription
uid
Yes
stringA unique random uid which is created on the Infopromo Communications – Bulk SMS Marketing platform and is returned upon creation of the object.
Example request
PHP
curl -X GET https://sms.infopromo.digital/api/http/sms/606812e63f78b \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"api_token":"{your api_token}"
}'
Returns

Returns a contact object if the request was successful.

JSON
{
    "status": "success",
    "data": "sms data with all details",
}

If the request failed, an error object will be returned.

JSON
{
    "status": "error",
    "message" : "A human-readable description of the error."
}
View all messages

API Endpoint

Markup
https://sms.infopromo.digital/api/v3/sms/
Example request
PHP
curl -X GET https://sms.infopromo.digital/api/http/sms \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"api_token":"{your api_token}"
}'
Returns

Returns a contact object if the request was successful.

JSON
{
    "status": "success",
    "data": "sms reports with pagination",
}

If the request failed, an error object will be returned.

JSON
{
    "status": "error",
    "message" : "A human-readable description of the error."
}