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 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
signature You can create a secret signature so we can sign the webhook requests with that secret in the header X-SMSFactor-Signature

Examples

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

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

Result Format

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