Register a webhook

Developing

POST

https://app.lamha.sa/api/v2/webhooks

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.lamha.sa/api/v2/webhooks' \
--header 'X-LAMHA-TOKEN: {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "event_type": "order.status.changed",
    "url": "https://your-app.com/hooks/lamha",
    "secret": "a-strong-shared-secret-min-16-chars",
    "active": true,
    "conditions": {
      "statuses": ["picked", "delivered"]
    }
  }'

Response Example

{
  "success": true,
  "msg": "The Webhook has been Registered",
  "data": {
    "id": 42,
    "event_type": "order.status.changed",
    "url": "https://your-app.com/hooks/lamha",
    "is_active": true,
    "created_at": "2026-09-01T10:21:27+00:00"
  },
  "created": true
}

Modified at 2026-09-01 09:19:45

List webhooks

Webhook For Nginx