Communication Webhooks - Salla Merchant API

The Communication webhooks provide notifications for all outgoing store communications, including SMS, email and whatsapp messages. They cover key events such as order updates, payment reminders, product availability alerts, marketing broadcasts, and customer engagement messages, ensuring developers can track and act on customer interactions in real time.

These webhook events are allowed only for Communication applications.

Data Schema

Type Details

Entity Type Details

Comunication Webhook

Every notification payload includes a locale field (ar or en) indicating the language of the content text and any localized labels in meta (e.g. meta.status.name on order.status.updated events). Use this value to match your provider's language settings or apply language-specific formatting when delivering notifications.

Examples

Below are some examples of the webhook events:

Example #1

{
  "event": "communication.sms.send",
  "merchant": 292111819,
  "created_at": "Mon Nov 10 2025 17:18:13 GMT+0300",
  "data": {
    "notifiable": [
      "+96656000000"
    ],
    "type": "order.status.updated",
    "content": "أصبحت حالة طلبك #218103278 [تم الشحن]",
    "entity": {
      "id": 1741773897,
      "type": "order"
    },
    "locale": "ar",
    "meta": {
      "customer_id": 239462497,
      "status": {
        "name": "تم الشحن"
      }
    }
  }
}

Example #2

Example #3

Example #4