developer | boolkyApiIntegrations

boolkyApiIntegrationsDesc

POST

sendSms

POST

calculateSmsPrice

POST

sendMms

POST

calculateMmsPrice

POST

callBack

GET

getSmsStatus

PUT

addContacts

GET

getContacts

POST

deleteContacts

PUT

addGroup

GET

getGroups

DELETE

deleteGroup

GET

getMessageHistoryGrouped

GET

getSingleMessageHistory

GET

getBalance

selectEndpoint:

sendSms

sendSmsDesc

requestUrl: https://api.boolky.net/sendSms

callBackUrlInfoText

      
{
  "smsStatus": "delivered",
  "groupHistoryId": "14874",
  "phoneNumber": "+18181111112",
  "segments": "1",
  "errorCode": null
}

requestHeaders

authorization: yourApiKey (getItOn dashboard)

language: EN

requestBody

      
{
  "phoneNumbers": [
    "+18181111112",
    "+18181111113",
    "+18181111114",
    "+18181111115"
  ],
  "text": "Hello. Message sent by Boolky.",
  "saveContacts": false
}

variable	type	validation	required	info
text	string	Min 1, Max 650 characters	true	Message what you want to sent.
phoneNumbers	string[]	Min 1 Number	true	Phone numbers to sent.
groupIds	int[]	null	false	Sent messages via groupIds, (Advanced).
contactIds	int[]	null	false	Sent messages via contactIds, (Advanced).
saveContacts	boolean	true / false	false	If you need to save contacts.

sendMmsResponseFields

cost - serviceCost
totalPartCount - totalPartCountDesc
receiverCount - receiverCountDesc
text - yourMessage

successResponse

      
{
  "result": {
    "data": {
      "cost": "0.0295",
      "bCoinCost": 295,
      "totalPartCount": 1,
      "receiverCount": 1,
      "text": "gsjfgsdjkfg",
      "sendAnywayCost": "0.0295",
      "bCoinSendAnywayCost": 295,
      "internationalTotalPartCount": 0,
      "internationalReceiverCount": 0,
      "selectedContactsSize": 1,
      "blackListContactsSize": 0,
      "invalidContactsSize": 0,
      "blockedCountryContactsSize": 0,
      "invalidContacts": [],
      "blackListContacts": [],
      "blockedCountryContacts": [],
      "groupHistoryId": 0,
      "messageId": "9c9392de-35ae-4ac9-a328-378b666c8f2f",
      "ids": [
        {
          "phone": "+13022512794",
          "uuid": "0e1e720a-7b87-4876-a844-7e44a6f3cfd6"
        }
      ]
    },
    "message": {
      "localizedMessage": "Successfully sent cost: $ 0.0295",
      "messageKey": "success"
    }
  }
}

errorResponse3Cases

ifYouHaveWrongApiKey
ifYouHaveEnoughFunds
ifYouHaveEnoughFundsPaymentError

errorResponseSessionExpired

      
{
  "error": {
    "localizedMessage": "Session expired",
    "messageKey": "sessionExpired"
  }
}

errorResponseInsufficientFunds

      
{
  "error": {
    "localizedMessage": "Account balance is not enough for this purchase, try to fund your account",
    "messageKey": "insufficientFunds"
  }
}

errorResponsePaymentError

      
{
  "error": {
    "localizedMessage": "Payment error.",
    "messageKey": "reject"
  }
}

ifYouHaveAnyQuestionsContactUs

company

aboutUs
contactUs
pricing
developer
faq

features

sendSmsOnline
sendMmsOnline
receiveSmsOnline
calculatePrice
groups

integrations

smsApis
mmsApis
importContacts
downloadHistory

useCases

socialNetwork
restaurantsHotels
deliveryCompanies
shops

privacyPolicy termsOfUse