Subscribe to webhooks

Purpose

Tell the platform to push real-time event notifications to your server. Subscribe to booking.created / booking.updated / booking.cancelled so your app reacts immediately instead of polling. Each subscription has its own signing secret for HMAC verification.

Authentication

Send your access token as a Bearer header: Authorization: Bearer <token>. Obtain it from Authenticate a user.

Parameters

Request samples

curl -X POST https://tourapi.nirajp.com.np/api/v1/integrations/webhooks \
  -H "Content-Type: application/json" \
  -d '{"targetUrl":"https://your-app.com/webhooks/booking","events":["booking.created","booking.cancelled"],"description":"Production sink"}'

Success response

Returns 200 OK with the shape below.

{
  "success": true,
  "message": "Request successful.",
  "data": {
    "id": 3,
    "targetUrl": "https://your-app.com/webhooks/booking",
    "events": [
      "booking.created",
      "booking.cancelled"
    ],
    "active": true
  }
}

Errors

All errors share the envelope { "success": false, "message": "..." }.

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "email": "email must be a valid email"
  }
}

{
  "success": false,
  "message": "Forbidden"
}

{
  "success": false,
  "message": "Internal server error"
}