Create a webhook

Webhooks are an easy way to receive information about the delivery of your campaign or the replies to your message. To create a webhook, you just have to log into our platform and go to the Developer menu or simply use the API.

POST

/webhook

Body Parameters

type
required
The webhook type (MO / DLR / STOP / CLICKER / BALANCE_ALERT)
url
required
The webhook url

Examples


POST /webhook HTTP/1.1
Host: api.smsfactor.com
Authorization: your.token
Accept: application/json

{
  "webhook":{
    "type": "DLR",
    "url": "https://yourserverurl.com"
  }
}
          
        

POST /webhook HTTP/1.1
Host: api.smsfactor.com
Authorization: your.token
Accept: application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<webhook>
  <type>DLR</type>
  <url>https://yourserverurl.com</url>
</webhook>
        
      

$response = \SMSFactor\Webhook::create([
  'webhook' => [
    'type' => 'DLR',
    'url' => "https://yourserverurl.com"
  ]
]);
$webhook_id = $response->webhook->webhook_id;
        
      

Result Format


{
  {
    "status": 1,
    "message": "OK",
    "webhook": {
        "webhook_id": "66",
        "type": "MO",
        "url": "https://yourserverurl.com"
    }
  }
}
          
        

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <status>1</status>
    <message>OK</message>
    <webhook>
      <webhook_id>66</webhook_id>
      <type>DLR</type>
      <url>https://yourserverurl.com</url>
    </webhook>
</response>