# Sms Webhook Events

Bitel uses webhook to let your servers know when a SMS request has been concluded.

To enable SMS request events, go to your project panel and under the Webhooks section enter a valid, reachable URL.

Make sure that the URL is accessible without any authorization, rate limiting or other restrictions.

{% hint style="info" %}
Once the URL has been setup, for each request ONLY one event is sent to your URL using POST method.
{% endhint %}

The event that is sent to your server URL contains the following informations:

| property          | Description                                                                      |
| ----------------- | -------------------------------------------------------------------------------- |
| requestId         | the identifier of the request                                                    |
| batchId           | the identifier of the batch                                                      |
| balanceSubtracted | the amount that is subtracted from the project balance, in Tomans                |
| cause             | call status (see Call Status table)                                              |
| smsCount          | count of sms parts                                                               |
| requestDate       | date of request, in epoch format                                                 |
| deliveryStatus    | status of delivery(see [SMS Detail](../../sms/sms-detail#delivery-status-table)) |
