Connector API
  • Mews Connector API
  • Getting started
  • Usage guidelines
    • Authentication
    • Requests
    • Responses
    • Environments
    • Serialization
    • Pagination
    • Best practices
  • Concepts
    • Multi-property
    • Restrictions
    • Taxation
    • Time units
  • Use cases
    • 'How to' use cases
    • Accounting
    • Customer loyalty
    • Customer management
    • Customer messaging
    • Data export
    • Device integration
    • Events
    • Guest technology
    • Housekeeping
    • Kiosk
    • Mews Payment Terminals
    • Payment automation
    • Point of sale
    • Reputation management
    • Revenue management
    • Upsell
  • API Operations
    • Common objects
    • Accounting categories
    • Accounting items
    • Accounts
    • Account notes
    • Addresses
    • Age categories
    • Availability adjustments
    • Availability blocks
    • Bills
    • Business segments
    • Cancellation policies
    • Cashiers
    • Cashier transactions
    • Commands
    • Companies
    • Companionships
    • Company contracts
    • Configuration
    • Counters
    • Countries
    • Credit cards
    • Currencies
    • Customers
    • Departments
    • Devices
    • Enterprises
    • Exchange rates
    • Exports
    • Identity documents
    • Images
    • Languages
    • Loyalty memberships
    • Loyalty programs
    • Loyalty tiers
    • Messages
    • Message threads
    • Order items
    • Orders
    • Outlet bills
    • Outlet items
    • Outlets
    • Payments
    • Payment requests
    • Preauthorizations
    • Product categories
    • Product service orders
    • Products
    • Rates
    • Rate groups
    • Reservations
    • Reservation groups
    • Resource access tokens
    • Resource blocks
    • Resources
    • Resource categories
    • Resource features
    • Restrictions
    • Routing rules
    • Rules
    • Service order notes
    • Service overbooking limits
    • Services
    • Source assignments
    • Sources
    • Tasks
    • Tax environments
    • Taxations
    • Vouchers
    • Voucher codes
  • API Events
    • Ways to communicate
    • General Webhooks
    • Integration Webhooks
    • Webhooks FAQ
    • WebSockets
  • Your integration journey
    • Certification
  • Deprecations
    • Migration guide: Get all reservations
  • Changelog
    • Changelog 2024
    • Changelog 2023
    • Changelog 2022
    • Changelog 2021
    • Changelog 2020
    • Changelog 2019
    • Changelog 2018
    • Changelog 2017
    • Changelog 2016
Powered by GitBook
On this page
  • Supported events
  • Request body
  • Webhook action
  • Webhook data
  • Integration created data
  • Enterprise
  • Service
  • Requestor
  • Integration
  • Integration enabled data
  • Integration disabled data
  • Integration canceled data
  • Integration reinstated data
  • Integration deleted data

Was this helpful?

  1. API Events

Integration Webhooks

PreviousGeneral WebhooksNextWebhooks FAQ

Last updated 5 months ago

Was this helpful?

This is an older form of Webhook, which only supports events related to changes in integration state. Unlike , each event generates an individual Webhook.

Supported events

Entity

Event

Description

Integration

IntegrationCreated

Event triggered when a new integration is created

Integration

IntegrationEnabled

Event triggered when a integration is enabled

Integration

IntegrationDisabled

Event triggered when a integration is disabled

Integration

IntegrationCanceled

Event triggered when a integration is canceled

Integration

IntegrationReinstated

Event triggered when a integration is reinstated

Integration

IntegrationDeleted

Event triggered when a integration is deleted

Terminology

An Integration refers to the unique connection between an Enterprise or Property (i.e. Mews customer) and an API client (i.e. Mews partner), corresponding to a unique Access Token. For a full description of all the terms used, see the .

Request body

{
    "Action": "IntegrationCreated",
    "Data": {
        "Enterprise": {
            "Id": "8865aa96-f62d-4f9b-a912-ab2100f60f42",
            "Name": "Sample Chain Hotel 1"
        },
        "Service": {
            "Id": "9745ce3a-8dbb-4cc0-a550-55f9ff67b242",
            "Name": "Accommodation"
        },
        "Requestor": null,
        "AccessToken":"9E5E84E9974D4F169662AB2200F27CB1-00B343A0DDA725CACAC028E38E3EABF",
        "CreatedUtc": "2019-12-13T14:42:52Z",
        "IsEnabled": true,
        "Integration": {
            "Id": "9e5e84e9-974d-4f16-9662-ab2200f27cb1",
            "Name": "WebhookTEST"
        }
    }
}
Property
Type
Contract
Description

Action

required

Type of action or event.

Data

object

required

Webhook action

Webhook data

Integration created data

Property
Type
Contract
Description

Enterprise

required

Property or chain of properties.

Service

optional

Service the integration is connected to.

Requestor

required

Person requesting the action or event.

AccessToken

string

required

Access token of the client application.

CreatedUtc

string

required

Creation date and time of the integration in UTC timezone in ISO 8601 format.

IsEnabled

bool

required

Whether integration is enabled.

Integration

required

Integration data.

Enterprise

Property
Type
Contract
Description

Id

string

required

Unique identifier of the enterprise.

Name

string

required

Name of the enterprise.

Service

Property
Type
Contract
Description

Id

string

required

Unique identifier of the service.

Name

string

required

Name of the service.

Requestor

Property
Type
Contract
Description

Name

string

required

Name of the requestor.

Email

string

required

Email of the requestor.

Integration

Property
Type
Contract
Description

Id

string

required

Unique identifier of the integration.

Name

string

required

Name of the integration.

Integration enabled data

Property
Type
Contract
Description

Integration

required

Integration data.

Integration disabled data

Property
Type
Contract
Description

Integration

required

Integration data.

Integration canceled data

Property
Type
Contract
Description

Integration

required

Integration data.

Integration reinstated data

Property
Type
Contract
Description

Integration

required

Integration data.

Integration deleted data

Property
Type
Contract
Description

DeletedUtc

string

required

Deletion date and time of the integration in UTC timezone in ISO 8601 format.

Integration

required

Integration data.

string

Structure of the object depends on .

IntegrationCreated - Triggered when a new integration is created. Data is .

IntegrationEnabled - Triggered when an integration is enabled. Data is .

IntegrationDisabled - Triggered when an integration is disabled. Data is .

IntegrationCanceled - Triggered when an integration is canceled. Data is .

IntegrationReinstated - Triggered when an integration is reinstated. Data is .

IntegrationDeleted - Triggered when an integration is deleted. Data is .

The structure of the Data object depends on .

General Webhooks
Mews Glossary for Open API users
Integration created data
Integration enabled data
Integration disabled data
Integration canceled data
Integration reinstated data
Integration deleted data
Webhook action
Webhook action
Webhook action
Enterprise
Service
Requestor
Integration
Integration
Integration
Integration
Integration
Integration