/
BulkGate developer documentation
/
Simple API
/
Promotional SMS – request methods
Promotional SMS – request methods
Request examples for the simple/promotional endpoint in every supported method. For the meaning of the parameters see the specification ; for ready-made code in individual languages see the examples .
GET method
Example of full request:
https:// portal.bulkgate.com /api/1.0/simple/promotional
? application_id = 451
& application_token = NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj
& number = 447700900000 ; 7811901234 ; 447712345678
& text = test_sms
& unicode = yes
& sender_id = gText
& sender_id_value = BulkGate
& country = gb
& schedule = 2018-05-14T18:30:00-01:00
Example of country request:
https:// portal.bulkgate.com /api/1.0/simple/promotional
? application_id = 451
& application_token = NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj
& number = 7811901234 ; 447712345678
& text = test_sms
& country = gb
Example of ISO 8601 request:
https:// portal.bulkgate.com /api/1.0/simple/promotional
? application_id = 451
& application_token = NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj
& number = 447700900000 ; 447811901234
& text = test_sms
& schedule = 2018-05-14T18:30:00-01:00
Example of unix timestamp request:
https:// portal.bulkgate.com /api/1.0/simple/promotional
? application_id = 451
& application_token = NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj
& number = 447700900000 ; 447811901234
& text = test_sms
& schedule = 1526992636
POST method - application/x-www-form-urlencoded
Example of full request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/x-www-form-urlencoded
application_id=451&application_token=NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj&number=447700900000;7811901234;447712345678&text=test_sms&unicode=yes&sender_id=gText&sender_id_value=BulkGate&country=gb&schedule=2018-05-14T18:30:00-01:00
Example of country request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/x-www-form-urlencoded
application_id=451&application_token=NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj&number=7811901234;447712345678&text=test_sms&country=gb
Example of ISO 8601 request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/x-www-form-urlencoded
application_id=451&application_token=NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj&number=447700900000;447811901234&text=test_sms&schedule=2018-05-14T18:30:00-01:00
Example of unix timestamp request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/x-www-form-urlencoded
application_id=451&application_token=NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj&number=447700900000;447811901234&text=test_sms&schedule=1526992636
POST method - application/json
Example of full request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/json
{
"application_id" : 451,
"application_token" : "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj" ,
"number" : "447700900000;7811901234;447712345678" ,
"text" : "test_sms" ,
"unicode" : true,
"sender_id" : "gText" ,
"sender_id_value" : "BulkGate" ,
"country" : "gb" ,
"schedule" : "2018-05-14T18:30:00-01:00"
}
Example of country request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/json
{
"application_id" : 451,
"application_token" : "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj" ,
"number" : "447700900000;7811901234;447712345678" ,
"text" : "test_sms" ,
"country" : "gb"
}
Example of ISO 8601 request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/json
{
"application_id" : 451,
"application_token" : "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj" ,
"number" : "447700900000;7811901234;447712345678" ,
"text" : "test_sms" ,
"schedule" : "2018-05-14T18:30:00-01:00"
}
Example of unix timestamp request:
POST /api/1.0/simple/promotional HTTP/1.1
Host : portal.bulkgate.com
Content-Type : application/json
{
"application_id" : 451,
"application_token" : "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj" ,
"number" : "447700900000;7811901234;447712345678" ,
"text" : "test_sms" ,
"schedule" : 1526992636
}
Was this page helpful?
thumb_up Yes
thumb_down No
Thank you for your feedback.