Webhook endpoints

Create Webhook endpoint

Use this operation to register a Webhook with Mews to receive notification events that you subscribed to. For more information, including details about supported events, see API Events.

Note: This operation needs Authentication.

Request

POST [PlatformAddress]/v1/webhook-endpoints

{
  "data": {
    "type": "webhookEndpoints",
    "attributes": {
      "targetUrl": "https://example.com/webhooks/receive"
    }
  }
}

Property	Type	Contract	Description
data	webhook_endpoint_create	required	The document's "primary data".

webhook_endpoint_create

Property	Type	Contract	Description
type	string	required	The type member is used to describe resource objects that share common attributes and relationships.
attributes	webhook_endpoint_attributes	required	An attributes object representing some of the resource's data.

Response

{
  "data": {
    "id": "83f93e1c-b6e1-4040-90cf-3274b6f3c82d",
    "type": "webhookEndpoints",
    "attributes": {
      "targetUrl": "https://example.com/webhooks/receive",
      "secret": "secret",
      "createdAt": "2024-10-24T08:44:45.409Z",
      "updatedAt": "2024-10-24T08:44:45.409Z"
    }
  }
}

Below is a list of all possible fields this endpoint can return including relationships fields fetched with include query parameter.

Property	Type	Contract	Description
targetUrl	string	required, max length 100 characters	The Webhook URL configured to receive event notifications from Mews.
secret	string	required, max length 100 characters	A string generated to ensure the authenticity of the webhook. It is used to verify that the webhook request comes from a trusted source.
createdAt	string	required, max length 25 characters	Created at timestamp in RFC 3339 format.
updatedAt	string	required, max length 25 characters	Updated at timestamp in RFC 3339 format.

Update webhook endpoint

This operation updates a webhook endpoint. It allows to subscribe or unsubscribe from events.

Note: This operation needs Authentication.

Request

PATCH [PlatformAddress]/v1/webhook-endpoints/{id}

{
  "data": {
    "type": "webhookEndpoints",
    "id": "83f93e1c-b6e1-4040-90cf-3274b6f3c82d",
    "attributes": {
      "events": [
        "booking.status.updated"
      ],
      "targetUrl": "https://example.com/webhooks/receive"
    }
  }
}

Property	Type	Contract	Description
data	webhook_endpoint_update	required	The document's "primary data".

webhook_endpoint_update

Property	Type	Contract	Description
type	string	required	The type member is used to describe resource objects that share common attributes and relationships.
attributes	webhook_endpoint_update_attributes	required	An attributes object representing some of the resource's data.

webhook_endpoint_update_attributes

Property	Type	Contract	Description
targetUrl	string	required, max length 100 characters	The Webhook URL configured to receive event notifications from Mews.
events	array of object string	required, max 1000 items	The list of events that will trigger the webhook.

Response

{
  "data": {
    "id": "83f93e1c-b6e1-4040-90cf-3274b6f3c82d",
    "type": "webhookEndpoints",
    "attributes": {
      "events": [
        "booking.status.updated"
      ],
      "targetUrl": "https://example.com/webhooks/receive",
      "createdAt": "2024-10-24T08:44:45.409Z",
      "updatedAt": "2024-10-24T08:44:45.409Z"
    }
  }
}

Below is a list of all possible fields this endpoint can return including relationships fields fetched with include query parameter.

Property	Type	Contract	Description
targetUrl	string	required, max length 100 characters	The Webhook URL configured to receive event notifications from Mews.
secret	string	required, max length 100 characters	A string generated to ensure the authenticity of the webhook. It is used to verify that the webhook request comes from a trusted source.
createdAt	string	required, max length 25 characters	Created at timestamp in RFC 3339 format.
updatedAt	string	required, max length 25 characters	Updated at timestamp in RFC 3339 format.