Webhook Configuration
To create a webhook, visit the Integration Hub and select the organisation you wish to configure. Navigate to the Webhooks page to manage webhooks for your organisation.
| Environment | Integration Hub URL |
|---|---|
| Production | integrations.mobiledock.com |
| Staging | integrations.staging.mobiledock.com |
Settings
Section titled “Settings”When creating a webhook, configure the following:
| Setting | Description |
|---|---|
| Name | The name of your webhook |
| Description (optional) | A description of your webhook |
| Webhook URL | The URL that Mobiledock will send events to |
| Headers (optional) | Custom headers added to each webhook request. All custom headers must be prefixed with x-, except for Authorization which does not require a prefix |
| Booking Events | Which booking events should trigger the webhook |
| Status Events | Specific statuses that should trigger the webhook |
| Include History | Whether the payload should contain the booking history |
| Include Comments | Whether the payload should contain the booking comments |
| Failure Notification Emails (optional) | Email addresses that receive a notification if the webhook fails |
Custom headers
Section titled “Custom headers”Custom headers let you authenticate incoming webhooks on your server. Common patterns:
- Set an
Authorizationheader with a shared secret - Set an
x-webhook-secretheader for verification