To interact with the Mews Connector API, you need to authenticate your requests using ClientToken
and AccessToken
. These tokens are supplied as parameters in the request body, ensuring that only authorized clients can access and manipulate data.
ClientToken
: Unique to your application, serving as the identifier of the API client.AccessToken
: Unique to the connection with a property (referred to as an enterprise in the API), identifying the property or properties whose data and services you can access.Client
: The name and version of the client application you are integrating with Mews.
Environment-specific: Note that each Mews environment (e.g., demo, production) requires a different set of tokens.
A unique AccessToken
is generated for each new enterprise (property) using your connection. This allows your application to access the data for that enterprise via the API.
Access Tokens typically allow access to a single, named enterprise. However, some tokens may be Portfolio Access Tokens, which facilitate multi-property operations. These tokens grant access to more than one enterprise with a single token. For more information, see Multi-property.
Public tokens are available for the demo environment. For more details, see Environments.
To receive credentials for production usage, you must successfully complete a certification process. After certification:
- Your integration profile will be created.
- You will automatically receive a unique
ClientToken
, which remains the same for all connections in the production environment. - A unique
AccessToken
will be generated and shared with you for each enterprise requesting to connect their Mews profile to your system.