# SMS provider webhooks

After you [connect an SMS provider](/developer/first-steps/connect-messaging-services/sms-configuration/), some providers need a webhook URL registered on their side so Pushwoosh can receive delivery receipts, incoming replies, or channel-specific events such as Viber subscription status. Other providers submit this URL automatically with every message, so no extra setup is required.

All webhooks are received at `https://tw-callback.svc-nue.pushwoosh.com/api/v1/...`. Where a URL includes `{APP_CODE}`, replace it with your [Pushwoosh application code](/developer/api-reference/api-identifiers/#application-code) (**Settings → Applications**).

## Automatic setup

For these providers, Pushwoosh submits the callback URL automatically with every message. No action is required on the provider's side.

* **Twilio:** delivery status is submitted automatically with each message. To also receive replies (two-way SMS), set your Twilio phone number's **"A message comes in"** webhook in the Twilio Console to:

  ```
  https://tw-callback.svc-nue.pushwoosh.com/api/v1/smsCallback/{APP_CODE}
  ```

* **SMSGlobal:** both delivery and incoming URLs are submitted automatically with each message.
* **SMSAla:** the delivery URL is submitted automatically with each message. SMSAla does not support incoming SMS.

## Manual setup required

For these providers, register the webhook URL once in the provider's own dashboard.

| Provider <div style="width:120px"></div> | Event <div style="width:140px"></div> | Method <div style="width:90px"></div> | URL <div style="width:280px"></div> |
|---|---|---|---|
| MStat | Delivery | POST | `.../mstatCallback` |
| MStat | Incoming | POST | `.../mstatIncoming/{APP_CODE}` |
| MStat | Viber subscription | POST | `.../mstatViberSubscription/{APP_CODE}` |
| Amazon SNS | Delivery | POST | `.../awsSmsCallback` |
| CapitoleMobile | Delivery | GET | `.../capitoleMobileCallback` |
| CapitoleMobile | Incoming | GET | `.../capitoleMobileIncoming/{APP_CODE}` |
| AbleMobile | Delivery | GET / POST | `.../amSmsCallback` |
| SMSTraffic | Delivery | POST | `.../smsTrafficCallback` |
| TextMe.co.il | Delivery | GET | `.../textMeCoilCallback` |
| TextMe.co.il | Incoming | GET | `.../textMeCoilCallback/{APP_CODE}` |

Each URL above is relative to `https://tw-callback.svc-nue.pushwoosh.com/api/v1`.

<Aside type="note" title="Amazon SNS">
Delivery receipts arrive through an SNS topic subscription, not a per-message parameter.

1. In the **AWS Console**, add an HTTPS subscription to your SMS delivery status topic. Use the `awsSmsCallback` URL from the table above.
2. When AWS sends a `SubscriptionConfirmation` request, find the `SubscribeURL` in the AWS Console under the pending subscription.
3. Open that URL to confirm the subscription.

Until you confirm the subscription, Pushwoosh does not receive delivery receipts.
</Aside>

## No webhook support

**Mobipace** and **SMSCenter** don't send delivery or incoming webhooks to Pushwoosh. No setup is possible or required for these providers.