Crawling: https://api-docs.everreal.co Crawling: https://api-docs.everreal.co ============================================================ Title: Introduction | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ### [](https://api-docs.everreal.co/#all-processes-digital-smart-and-as-simple-as-possible)All processes digital, smart and as simple as possible! With EverReal you get a digital solution that not only makes your day-to-day work much easier, but also significantly increases the profitability of individual areas of responsibility in real estate management and marketing. While speed in the selection of prospects and applicants, customer satisfaction through quick reactions, ability to provide information to clients and quality levels in communication increase, error rates decrease due to uniform templates, processing time through automated processes and smart functions. Using this API you can connect to most of the functionality that Everreal has to offer. Here are some things that you can do: - import & update master data (owners/property/unit/tenants) - Configure Webhooks for varieties of purposes [NextAuthentication](https://api-docs.everreal.co/master)Last updated 11 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co Crawling: https://api-docs.everreal.co/master ============================================================ Title: Authentication | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master)- [API ClientID and ClientSecret](https://api-docs.everreal.co/master/api-clientid-and-clientsecret) - [Authentication limitations](https://api-docs.everreal.co/master/authentication-limitations) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Requirements](https://api-docs.everreal.co/master#requirements) - [Authentication](https://api-docs.everreal.co/master#authentication) - [Refresh token in case it expires](https://api-docs.everreal.co/master#refresh-token-in-case-it-expires) - [User information](https://api-docs.everreal.co/master#user-information) Was this helpful? ## [](https://api-docs.everreal.co/master#requirements)Requirements EverReal APIs supports jwt tokens using [Bearer token](https://jwt.io/introduction) according to [RFC-7519](https://datatracker.ietf.org/doc/html/rfc7519). This allows us to protect our information and make sure, who is requesting has correct authorization to execute the operation. #### [](https://api-docs.everreal.co/master#oauth-2.0-password-grant)OAuth 2.0 Password Grant **Important!** You should use the password grant only in server-to-server communication, where you completely trust the client. This allows you to use the username and password to get the refresh_token. After refresh_token is obtain, username and password is not needed. ## [](https://api-docs.everreal.co/master#authentication)Authentication POST https://{custom_subdomain}.everreal.co/accounts/oauth/token #### [](https://api-docs.everreal.co/master#headers)Headers NameTypeDescriptionContent-Type string application/json #### [](https://api-docs.everreal.co/master#request-body)Request Body NameTypeDescriptionPayload body object { "username": "john.doe@everreal.co", "password": "Password", "client_id": "", "client_secret": "", "scope": "offline_access *", "grant_type": "password" } 200 403 Copy{ "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJjYTdhZDI2MC1mNmE3LTQ1OWEtOWNjYy1kNTMzMzNjY2M1Y2EiLCJzdWIiOiI3NmFmY2FiMC02NTJiLTQ1NDctODAxYi03YzcwMWMwOTdiODEiLCJleHAiOjE2Mjg1OTYyNTYsImlhdCI6MTYyODU5MjY1Nn0.nnBmf0r7oTsqDYxwkA9seO-aZGhLY3z-ZodFn2NSa9gPOxCCtXvACj7UNIifd03KbqLDiJcpqj5anUzyKpXY0taXRCPMVHB78iVYDyKR8rZqNZ7PP8XSXvxxLaZPfTiqYG01pzCgaDWHwgpUsBoFRJDr2rPt1ShD6Pe-efcZIQfS81jGUAw4dYAwnot6zNC6uNY8OkihEUEwnsVI1mCfjvmrWL6cHmL-YSko-gPUGAjF1ulSJZ68CcMTrsC2tXnWLAMyiJMu9_VWoLXUgQJH2FzISeJkyPCJbnzDlMmAYfe8Kq0z8QL_l2q_cs2aOAvre-jJpyri-dsP-6hR2ODL4g", "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2ZWU5YzFhNi1hMWM5LTQwOWQtYjJjOS03NjdlZGRlMzAwNDQiLCJzdWIiOiI3NmFmY2FiMC02NTJiLTQ1NDctODAxYi03YzcwMWMwOTdiODEiLCJleHAiOjE2MzExODQ2NTYsImlhdCI6MTYyODU5MjY1Nn0.IcdmncHIE3PTxix5QS5bZAm3JsPDprRqyEU6pEk09mViV-V9F8EWlYofDuQglfB5vNe_oBzZWmu3wdxGm7hO-9Z_sveI6OEBy-mv_-bHarIRytToH7zjSkl4BO_l-s48hwxGVYyQLtFX1G9vU-ykJ4Bwd4M6V1Z-0gwW65MCFn6CXgAz8lXgDLoLorwoxGjZVMKFmjNQcNLLdcLXDNXXYdU6d2bjJQLz6hzixbqhUFYbR6hZUbEJ6cBZsKWZjsvDydtJ9froWR3d4C4tbYkirmSGvZHjvtwVrjKnoHtAd0MQ8UVTKxrH7jTcATrCmWDaxyW2XFcd7HtuI3_TdQH8aw", "expires_in": 3600, "token_type": "Bearer" }Copy{ "error": "invalid_grant", "error_description": "heimdall.validation.user.does.not.exist" } - Make sure to store the refresh_token securely. - Currently the refresh_token has an expiration between 4 weeks and 2 years, it is configurable by EverReal for each customer. After it expires you need to re-authenticate with username and password - The access_token expires by default every hour, but also can be configurable by EverReal to have another expiration time (it is described by the expires_in property). Use the refresh_token to generate a new one if you get an unauthorized response Bellow you can see some examples to get token correctly. BashC#(RestSharp)JSPythonCopycurl --location --request POST 'https://{custom_subdomain}.everreal.co/accounts/oauth/token' \ --header 'Content-Type: application/json' \ --header 'Cookie: accept-language=de-DE' \ --data-raw '{ "username": "john.doe@everreal.co", "password": "Password", "client_id": "", "client_secret": "", "scope": "offline_access *", "grant_type": "password" }'Copyvar client = new RestClient($"https://{custom_subdomain}.everreal.co/accounts/oauth/token"); client.Timeout = -1; var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Cookie", "accept-language=de-DE"); var body = @"{ " + "\n" + @"""username"": ""john.doe@everreal.co"", " + "\n" + @"""password"": ""Password"", " + "\n" + @"""client_id"": """", " + "\n" + @"""client_secret"": """", " + "\n" + @"""scope"": ""offline_access *"", " + "\n" + @"""grant_type"": ""password"" " + "\n" + @"}"; request.AddParameter("application/json", body, ParameterType.RequestBody); IRestResponse response = client.Execute(request); Console.WriteLine(response.Content);Copyvar axios = require('axios'); var data = JSON.stringify({ "username": "john.doe@everreal.co", "password": "Password", "client_id": "", "client_secret": "", "scope": "offline_access *", "grant_type": "password" }); var config = { method: 'post', url: `https://{custom_subdomain}.everreal.co/accounts/oauth/token`, headers: { 'Content-Type': 'application/json', 'Cookie': 'accept-language=de-DE' }, data : data }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); }); Copyimport requests import json url = "https://{custom_subdomain}.everreal.co/accounts/oauth/token" payload = json.dumps({ "username": "john.doe@everreal.co", "password": "Password", "client_id": "", "client_secret": "", "scope": "offline_access *", "grant_type": "password" }) headers = { 'Content-Type': 'application/json', 'Cookie': 'accept-language=de-DE' } response = requests.post(url, headers=headers, data=payload) print(response.text)**client_id**and **client_secret**are parameter provided by EverReal #### [](https://api-docs.everreal.co/master#oauth2.0-authorization-code-flow)Oauth2.0 Authorization Code Flow **Important!**Use the Authorization Code Flow in not trusted environments, like Web or Mobile app clients. Below are the necessary endpoints for the Authorization Code Flow. CopyauthorizationUri="https://${subdomain}.everreal.co/accounts/dialog/authorize" accessTokenUri="https://${subdomain}.everreal.co/accounts/oauth/token" tokenInfoUri="https://${subdomain}.everreal.co/accounts/api/tokeninfo?access_token={token}" revokeTokenUri="https://${subdomain}.everreal.co/accounts/api/tokenrevoke?token={token}" userInfoUri="https://${subdomain}.everreal.co/accounts/api/userinfo"A basic next.js example can be over our github page [https://github.com/EverRealGMBH/everreal-nextjs-nextauth-oauth2-example](https://github.com/EverRealGMBH/everreal-nextjs-nextauth-oauth2-example): Next.js exampleRead more here: [https://next-auth.js.org/v3/configuration/providers#using-a-custom-provider](https://next-auth.js.org/v3/configuration/providers#using-a-custom-provider) Copy{ id: "everreal", name: "EverReal", type: "oauth", version: "2.0", scope: "offline_access *", params: { grant_type: "authorization_code" }, accessTokenUrl: `https://${subdomain}.everreal.co/accounts/oauth/token`, requestTokenUrl: `https://${subdomain}.everreal.co/accounts/oauth/token`, authorizationUrl: `https://${subdomain}.everreal.co/accounts/dialog/authorize`, profileUrl: `https://${subdomain}.everreal.co/accounts/api/userinfo`, async profile(profile, tokens) { return { ...profile } }, clientId: "provided by everreal", clientSecret: "provided by everreal" }#### [](https://api-docs.everreal.co/master#refresh-access_token-api-endpoint)Refresh access_token API endpoint ## [](https://api-docs.everreal.co/master#refresh-token-in-case-it-expires)Refresh token in case it expires POST https://{custom_subdomain}.everreal.co/accounts/oauth/token Refresh the access_token in case it expires #### [](https://api-docs.everreal.co/master#headers-1)Headers NameTypeDescriptionContent-Type string application/json #### [](https://api-docs.everreal.co/master#request-body-1)Request Body NameTypeDescription string { "grant_type":"refresh_token", "client_id": "{secret}", "client_secret": "{secret}", "refresh_token":"{refresh_token}" } 200 Copy{ "access_token": "NEW TOKEN", "expires_in": "3600" }Use the access_token to authenticate to any protected endpoint by passing it to the “Authorization” header like this: “Authorization: Bearer MY_ACCESS_TOKEN” ## [](https://api-docs.everreal.co/master#user-information)User information GET https://{custom_subdomain}.everreal.co/accounts/api/users/me Based on Bearer token provided in header request, it will retrieve user information and all information about it. #### [](https://api-docs.everreal.co/master#headers-2)Headers NameTypeDescriptionContent-Type string application/json Authorization string Bearer token 200 Copy{ "id": "76dccab0-652e-4543-802c-7c701c098ad3", "email": "john.doe@ovooovo.com", "isActive": true, "firstName": null, "lastName": null, "profilePhoto": null, "profileData": { "language": "en-US" }, "isTenant": false, "createdAt": "2021-07-19T14:21:50.215Z", "updatedAt": "2021-07-19T14:21:50.215Z", "areTermsAccepted": true, "companies": [ { "id": "76dccab0-652e-4543-802c-7c701c0b3bb3", "name": "automation-reporting-qa", "isDefault": true } ], "currentCompany": { "id": "76dccab0-652e-4543-802c-7c701c0b3bb3", "name": "automation-reporting-qa", "partner": { "id": "76dccab0-652e-4543-802c-7c701c046579", "name": "test-documentation", "subdomain": "test-documentation" }, "isDefault": true }, "tokenInfo": { "audience": "76dccab0-652e-4543-802c-7c701c0a68f6", "scope": [ "offline_access", "company_contracting_edit_contract", "message_templates_all", "company_portfolio_all", "company_user", "email_templates_all" ], "user_id": "76dccab0-652e-4543-802c-7c701c097b81", "expires_in": 3571 } }[PreviousIntroduction](https://api-docs.everreal.co/)[NextAPI ClientID and ClientSecret](https://api-docs.everreal.co/master/api-clientid-and-clientsecret)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/master Crawling: https://api-docs.everreal.co/master/api-clientid-and-clientsecret ============================================================ Title: API ClientID and ClientSecret | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master)- [API ClientID and ClientSecret](https://api-docs.everreal.co/master/api-clientid-and-clientsecret) - [Authentication limitations](https://api-docs.everreal.co/master/authentication-limitations) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To be able to authenticate over Everreal API, you will need an API ClientID and ClientSecret. For now it's only possible to get an API ClientID and Client Secret only by emailing [support@everreal.co](mailto:support@everreal.co). Please drop us a line and we will generate them for you. [PreviousAuthentication](https://api-docs.everreal.co/master)[NextAuthentication limitations](https://api-docs.everreal.co/master/authentication-limitations)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/master/api-clientid-and-clientsecret Crawling: https://api-docs.everreal.co/master/authentication-limitations ============================================================ Title: Authentication limitations | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master)- [API ClientID and ClientSecret](https://api-docs.everreal.co/master/api-clientid-and-clientsecret) - [Authentication limitations](https://api-docs.everreal.co/master/authentication-limitations) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? A maximum of 50 refresh tokens are allowed per combination if client_id and user_id. When this limit is exceeded, older refresh tokens are automatically deleted. To be able to use our API, you will need an access_token that is generated most of the times via a refresh_token. An access_token has usually a life-time of 1 hour, but a refresh_token has a bigger life time, by default from 4 weeks to 3 years. Token typeMaximum tokensrefresh_token 50 per client_id and user_id access_token Infinite Important: Please make sure to store refresh_token in redis or some similar caching provider, and ALWAYS in a secure storage. [PreviousAPI ClientID and ClientSecret](https://api-docs.everreal.co/master/api-clientid-and-clientsecret)[NextRate limiting](https://api-docs.everreal.co/rate-limiting)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/master/authentication-limitations Crawling: https://api-docs.everreal.co/rate-limiting ============================================================ Title: Rate limiting | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? You can make **300 requests per minute** to each API in our system. Check the returned HTTP headers of any API request to see your current rate limit status. When you reached your rate limit, the API will return 429 status code By default we return the following status codes Status codeDescription200 Success 429 Too many requests from rate limiting And the following headers Response headerDescriptionX-RateLimit-Limit The maximum number of requests that the consumer is permitted to make per minute (by default 300 per minute). X-RateLimit-Remaining The number of requests remaining in the current rate limit window. X-RateLimit-Reset The number of seconds to wait until the rate limit window resets. This header is sent for each response. Here is an example in python to handle rate limiting Copy#make sure you have requests installed or run the following pip3 install requests from datetime import datetime from time import sleep import requests url = "https://{subdomain}.everreal-dev.co/api/reporting/graphql" token = 'ey...' payload="{\"query\":\"query {\\r\\n users(input: { paging: { take: 10, skip: 0 }, filter: { email: \\\"email@domain.com\\\" } }) {\\r\\n id\\r\\n email\\r\\n }\\r\\n}\",\"variables\":{}}" headers = { 'Authorization': f'Bearer {token}', 'Content-Type': 'application/json', } for i in range(0,100): response = requests.request("POST", url, headers=headers, data=payload) print(f"response code {response.status_code} at {datetime.now()}") print("remaining", response.headers['X-RateLimit-Remaining']) if(response.headers['X-RateLimit-Remaining'] == 0): print(f"Sleeping {response.headers['X-RateLimit-Reset']}") sleep(int(response.headers['X-RateLimit-Reset'])) print("-------------------------------------------------------")[PreviousAuthentication limitations](https://api-docs.everreal.co/master/authentication-limitations)[NextHelpers](https://api-docs.everreal.co/helpers)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/rate-limiting Crawling: https://api-docs.everreal.co/helpers ============================================================ Title: Helpers | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers)- [Errors](https://api-docs.everreal.co/helpers/errors) - [Pagination](https://api-docs.everreal.co/helpers/pagination) - [Formatting](https://api-docs.everreal.co/helpers/formatting) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [Errors](https://api-docs.everreal.co/helpers/errors)[Pagination](https://api-docs.everreal.co/helpers/pagination)[Formatting](https://api-docs.everreal.co/helpers/formatting)[PreviousRate limiting](https://api-docs.everreal.co/rate-limiting)[NextErrors](https://api-docs.everreal.co/helpers/errors)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/helpers Crawling: https://api-docs.everreal.co/helpers/errors ============================================================ Title: Errors | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers)- [Errors](https://api-docs.everreal.co/helpers/errors) - [Pagination](https://api-docs.everreal.co/helpers/pagination) - [Formatting](https://api-docs.everreal.co/helpers/formatting) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Our API returns standard HTTP success or error status codes. For errors, we will also include extra information about what went wrong encoded in the response as JSON. The various HTTP status codes we might return are listed below. When requesting data to graphQL endpoints you will always get a 200 OK response, In those cases look for object `errors` to find the error information. ### [](https://api-docs.everreal.co/helpers/errors#errors-http-status-codes)HTTP StatusCode CodeTitleDescription200 OK The request was successful. 400 Bad request Bad request 403 Unauthorized Your API key is invalid. 404 Not found The resource does not exist. 429 Too Many Requests The rate limit was exceeded. 50X Internal Server Error An error occurred with our API. [PreviousHelpers](https://api-docs.everreal.co/helpers)[NextPagination](https://api-docs.everreal.co/helpers/pagination)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/helpers/errors Crawling: https://api-docs.everreal.co/helpers/pagination ============================================================ Title: Pagination | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers)- [Errors](https://api-docs.everreal.co/helpers/errors) - [Pagination](https://api-docs.everreal.co/helpers/pagination) - [Formatting](https://api-docs.everreal.co/helpers/formatting) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To use pagination in your API, you need to specify two parameters in your request: take and skip. The take parameter determines how many items you want to receive in each response, while the skip parameter determines how many items you want to skip from the beginning of the data set. For example, if you have 100 items in total and you want to get 10 items per page, you can use take=10 and skip=0 for the first page, take=10 and skip=10 for the second page, and so on. By using pagination, you can improve the performance and usability of your API. Copy# usage of pagination with owners query { owners(input: {filter: , paging: {skip:0, take:50}}) { id } } [PreviousErrors](https://api-docs.everreal.co/helpers/errors)[NextFormatting](https://api-docs.everreal.co/helpers/formatting)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/helpers/pagination Crawling: https://api-docs.everreal.co/helpers/formatting ============================================================ Title: Formatting | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers)- [Errors](https://api-docs.everreal.co/helpers/errors) - [Pagination](https://api-docs.everreal.co/helpers/pagination) - [Formatting](https://api-docs.everreal.co/helpers/formatting) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Country Code Formatting](https://api-docs.everreal.co/helpers/formatting#country-code-formatting) - [Currency Formatting](https://api-docs.everreal.co/helpers/formatting#currency-formatting) - [Date Formatting](https://api-docs.everreal.co/helpers/formatting#date-formatting) - [Decimals](https://api-docs.everreal.co/helpers/formatting#decimals) Was this helpful? ### [](https://api-docs.everreal.co/helpers/formatting#country-code-formatting)**Country Code Formatting** ISO 3166 is the international standard for country codes and the codes of their subdivisions. The standard is intended for use in any application requiring the expression of current country names in coded form. An alpha-2 code is a two-letter code that represents a country name. Following are some of the eg and make sure ISO is passed when country is used. CountryISO CodeGermany DE Austria AT Swiss CH France FR ### [](https://api-docs.everreal.co/helpers/formatting#currency-formatting)**Currency Formatting** ISO 4217 is the international standard for currency codes. It includes a three-letter alphabetic code for each currency. For example, USD is the code for US dollars, EUR is the code for Euros, and GBP is the code for British Pounds. ### [](https://api-docs.everreal.co/helpers/formatting#date-formatting)**Date Formatting** ISO 8601 specifies numeric representations of date and time. This standard notation helps to avoid confusion in international communication caused by the many different national notations and increases the portability of computer user interfaces. The international standard date notation is **YYYY-MM-DD** where YYYY is the year in the usual Gregorian calendar, MM is the month of the year between 01 (January) and 12 (December), and DD is the day of the month between 01 and 31. For example, the fourth day of February in the year 1995 is written in the standard notation as **1995-02-04** ### [](https://api-docs.everreal.co/helpers/formatting#decimals)**Decimals** A decimal is a way of writing a number that is not whole. A decimal has two parts: a whole number part and a fractional part. The fractional part is written with a decimal point and one or more digits after it. For example, 3.14 is a decimal number with a whole number part of 3 and a fractional part of 0.14. Decimals can be used to represent fractions, percentages, measurements, and more. [PreviousPagination](https://api-docs.everreal.co/helpers/pagination)[NextHow to guide](https://api-docs.everreal.co/how-to-guide)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/helpers/formatting Crawling: https://api-docs.everreal.co/how-to-guide ============================================================ Title: How to guide | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)[Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data)[PreviousFormatting](https://api-docs.everreal.co/helpers/formatting)[NextEverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide Crawling: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process ============================================================ Title: EverReal Data Import Process | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)- [Connect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration) - [Import Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) - [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data) - [Debug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports) - [FAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? This system is designed to make your onboarding process as seamless as possible by allowing you to upload your data in a simple and secure way. Whether you want to import properties, owner, units, tenants, bank accounts, or any other data related to your real estate business, EverReal has you covered. How do we make it easy? EverReal provides you with all the infrastructure you need to get started with your data import. We provide you with FTP to which you can add your files in form of zip and this is then subjected to pre-processing and valid data is added to EverReal. The import process consists of three stages, which are illustrated in the image below: **Stage 1**: Upload your data files to our FTP server. You can find the FTP credentials and the server address in the integration details page of your Integration. You can upload your data files in CSV format (delimiter ; ), compressed in a ZIP file. We also provide you the ability to replace/default/grok replacement for your CSV data which defines how your data fields are mapped to EverReal's data model, so if you wish to change your data make sure you navigate to our [mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) tab and make all the changes to your needs before uploading your file. **Stage 2**: Process your data files using mapping configuration, once you upload your data files, our system will automatically process them using the mapping configuration and generate a subset of valid items that can be imported to EverReal. **Stage 3**: Import your valid data items to EverReal. You can review the valid data items imported to EverReal from our Event log tab in the integrations detail page. You can also download the processed CSV file to understand which data items were invalidated and why. We also download and review the processed file with reference to the data thats been imported to Everreal . That's it! You have successfully imported your data to EverReal. You can now enjoy the benefits of our platform and manage your real estate business more efficiently and effectively. Here are few articles that will help your understanding more about our process and best practices to get started with importing data [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration)**How to connect an integration** [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)**How to prepare files for Import** [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#sample-dataset-for-imports)**Sample Dataset for your import** [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers)**How to Set mappers for the Import** [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports)**How to debug import** [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq)**Commonly Asked Questions** [PreviousHow to guide](https://api-docs.everreal.co/how-to-guide)[NextConnect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process Crawling: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration ============================================================ Title: Connect an Integration | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)- [Connect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration) - [Import Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) - [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data) - [Debug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports) - [FAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? If you want to create an integration with EverReal, you don't need to worry about complex coding or configuration. You can simply connect your data source with one click from the integration pages. Just choose the one that suits your needs and click on Connect. integrations list pageAfter you click on Connect, you will be redirected to a detail page where you can view more information about the integration. This page has four major sections: Integration detail page- The first section is **Summary**, where you can find the FTP information for your integration. This includes the host name, port number, user name, password, and folder name. You can use this information to upload your data files to EverReal. Make sure that you use SFTP to establish connection. - The second section is **Mappers**, where you can create your own mapping configuration that helps in transforming your data to your desired format. You can also customize the fields and values that you want to map to EverReal's data model. - The third section is **Event Logs**, where you can monitor the status and progress of your integration. This section shows you the events that happened in the integration, such as when a file was uploaded, how many entities were loaded to EverReal, etc. You can also see if there were any errors or warnings during the integration process and take action accordingly. - The fourth section is Processed **File History**, where you can access the historical records of your integration files. This section helps you to understand the errors and also visualize the transformed values. You can download or view the files and see how the mapper transformed your data to EverReal's format. This can help you improve your data quality and efficiency. [PreviousEverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)[NextImport Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration Crawling: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers ============================================================ Title: Import Mappers | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)- [Connect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration) - [Import Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) - [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data) - [Debug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports) - [FAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Defaulting Rule](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#defaulting-rule) - [Grok Replacement](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#grok-replacement) - [Other Applicable Rules](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#other-applicable-rules) - [Value Replacement](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#value-replacement) Was this helpful? Mappers are one of the key features of the EverReal data importer and allow you to customize how your data is processed and transformed before loading it to EverReal. Mappers can help you solve data compatibility issues, improve data quality, and save time and manual work. Mappers work by applying rules to your data fields based on the conditions and actions you specify. For example, you can use a mapper to change the format of a number field, replace a missing value with a default one, or convert a text field using grok. This ensures your data is consistent and accurate. To use mappers, navigate to your integration detail page and select the tab mappers. Here you could see sections for 5 different entities: Owner, Property, Units, Tenants, and Bank account. In each section you could see the csv headers in the list and clicking on edits bring a set of operations that you can process, Here you can add functions for pre-processing value replacement etc. Following is an example mapper UI Mapper UIOnce you have a mapping template saved, you can use it to import your data source to EverReal. The EverReal data importer will apply the mappers and their rules to your data fields and transform them accordingly. You could also download the results of the mappers from the history tab to increase efficiency, and make any adjustments if needed. Mappers are a powerful tool that can help you streamline your data import process and ensure that your data is clean and compatible with EverReal. With mappers, you can focus on your business goals and not worry about your data issues. ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#defaulting-rule)Defaulting Rule Defaulting in mapping is a useful feature that allows you to specify a default value for a field in case the value is missing from the source data. For example, if you are mapping a property type is missing in your EPR, you can use defaulting to assign a generic name like "RESIDENTIAL" to those rows. To use defaulting in mapping, you need to add the default value in the default value section of the mapping configuration. You can enter any value that is compatible with the target field type, such as a string, a number, or a date. Defaulting in mapping helps you avoid errors and gaps in your data transformation process. ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#grok-replacement)Grok Replacement Grok replacer is a tool that allows you to replace values in your data that follow a certain pattern. For example, if you have a field that contains the floor number of a building, and you want to convert it from a format like 0.OG to a numerical format like 0, you can use grok replacer to extract the number from the original value and replace it with the new value. This can help you simplify your data processing and avoid repeating the same replacement for multiple values. To use grok replacer, you need to specify the pattern of the value you want to replace, and the format of the new value you want to generate. You can use regular expressions or predefined grok patterns to match the value. You can also use variables to capture parts of the value and use them in the new value. For example, if your original value is 0.OG and you want to replace it with 0, you can use the following grok pattern: %{NUMBER:floor}.%{WORD:og} This pattern will match any value that has a number followed by a dot and a word, and assign them to the variables floor and og. Then, you can use the following format for the new value: floor This format will use the value of the floor variable as the new value. So, if your original value is 0.OG, the new value will be 0. You can apply this grok replacer to any field that has a similar pattern in your data. ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#other-applicable-rules)Other Applicable Rules **Street Name & Street Number Extractor** Used to split address fields into separate components to match the requirements of the respective target fields. - **Street Name Extractor** Extracts the street name from a full address string. **Example**: Musterstraße 8 → Musterstraße - **Street Number Extractor** Extracts the street number from a full address string. **Example**: Musterstraße 8 → 8 These extractors are useful when address data is stored in a single column but needs to be mapped to separate fields in EverReal. They can be configured directly in the mapper for fields such as street and streetNumber. ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers#value-replacement)Value Replacement Value replacement is a technique that allows you to modify your text by replacing a value of it with different values. For example, you can use value replacement to change the Wohnung to Apartment. When using value mapper, make sure that the validate rules (eg: validate unit type, validate subtype etc..) are removed and kept empty. The role of rule is to try align automatically with EverReal values and if selected and when system cannot match, it uses given default value. This prevents value replacement from happening. [PreviousConnect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration)[NextIdeal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers Crawling: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data ============================================================ Title: Ideal CSV Structure | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)- [Connect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration) - [Import Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) - [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data) - [Debug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports) - [FAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Recommended Owner File Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-owner-file-structure) - [Recommended Property File Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-property-file-structure) - [Recommended Unit File Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-unit-file-structure) - [Recommended Tenant File Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-tenant-file-structure) - [Recommended Bank Account File Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-bank-account-file-structure) - [Sample Dataset for imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#sample-dataset-for-imports) Was this helpful? This section contains detailed specifications for preparing CSV files for import. We explain the required file structure for five modules: **Owner** (owners.csv), **Property** (objects.csv), **Unit** (units.csv), **Tenant**(tenants.csv), and **Bank Account** (bank_accounts.csv). Each module corresponds to a different type of data that can be imported into the EverReal system. Each module has its own CSV file with a specific set of columns and values that must be followed for a successful import. If all guidelines are correctly followed, mappers are not required. **Important:** All core modules (owner, property, unit, tenant) must be included in every import. Missing any of these files will result in import failure. The bank_accounts.csv file is optional. For formatting guidelines, please see our [helper section](https://api-docs.everreal.co/helpers) If you would like to use a CSV template, there is one attached at the end of the page. For the most up-to-date version, please contact our support team at **support@everreal.co** ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-owner-file-structure)Recommended Owner File Structure The owner module contains information about the owners of the properties and following are the field requirements. owner_id must be unique and serves as the external identifier. Everreal FieldCSV FieldData TypeRequiredDefaultDescriptionownerId owner_id String Yes - external owner_id reference firstName first_name String Yes - owner's first name lastName last_name String Yes - owner's last name email email Email No - owner's email companyName company_name String No - owner's company name street street String No - owner's street name streetNumber street_number String No - owner's street number zipCode zip_code String No - owner's zipcode city city String No - owner's city country country String No - owner's country ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-property-file-structure)Recommended Property File Structure The property module contains information about the properties themselves, such as the address and type. The following are the field requirements. property_id must be unique and serves as the external identifier. Everreal FieldCSV FieldData TypeRequiredDefaultDescriptionpropertyId property_id String Yes - external property_id reference ownerId owner_id String No - external owner_id reference name property_name String Yes property name type property_type String Yes BUILDING property type category property_category String Yes RESIDENTIAL_AND_COMMERCIAL property category street street String Yes property street name streetNumber street_number String Yes property street number zipCode zip_code String Yes property zipcode city city String Yes property city country country String Yes property country noOfFloors number_of_floors Decimal No 0 number of floors for the property yearBuilt year_built Number No year of build for the property ownershipType ownership_type String Yes INDIVIDUAL propery ownership type ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-unit-file-structure)Recommended Unit File Structure The unit module contains information about the individual units within a property, such as number, size and rent. Following are the field requirements. unit_id must be unique and serves as the external identifier. Everreal FieldCSV FieldData TypeRequiredDefault ValueDescriptionunitId unit_id String Yes - external unit_id reference propertyId property_id String Yes - external property_id reference ownerId owner_id String Yes - external owner_id reference name unit_name String Yes unit name category category String Yes RESIDENTIAL unit category type type String Yes APARTMENT unit type subType sub_type String Yes NO_INFORMATION unit subtype surfaceCommercial surface_commercial Decimal No 0 surface if unit type is commercial livingSurfaceResidential living_surface_residential Decimal No 0 surface if unit type is residential rooms rooms Decimal Yes 0 no of rooms bathrooms bathrooms Number Yes 0 no of bathrooms bedrooms bedrooms Decimal Yes 0 no of bedrooms hasMainStorage has_main_storage Boolean Yes FALSE does it has main storage floorNo floor_number Decimal Yes 0 floor number of unit currentRent current_rent Decimal No current rent of unit hasParking has_parking Boolean Yes FALSE parking available for this unit energyEfficiencyClass energy_efficiency_class String No energy efficiency class on energy certificate(Possible values can be found under [enum mapping](https://api-docs.everreal.co/endpoints/units/units-mutation#enum-table-maps)for ENERGY_EFFICIENCY_CLASS) buildingEnergyRatingType building_energy_rating_type String No building energy rating type on energy certificate(Possible values can be found under [enum mapping](https://api-docs.everreal.co/endpoints/units/units-mutation#enum-table-maps)for BUILDING_ENERGY_RATING_TYPE) energyCertificateCreationDate energy_certificate_creation_date String No energy certificate creation date(Possible values can be found under [enum mapping](https://api-docs.everreal.co/endpoints/units/units-mutation#enum-table-maps)for ENERGY_CERTIFICATE_CREATION_DATE) energyPerformanceCertificateAvailability energy_performance_certificate_availability String No is energy performance certificate available(Possible values can be found under [enum mapping](https://api-docs.everreal.co/endpoints/units/units-mutation#enum-table-maps)for ENERGY_SOURCE_TYPE) mainEnergySource main_energy_source String No main energy source according to energy certificate(possible values can be found in [unit mutation](https://api-docs.everreal.co/endpoints/units/units-mutation) under ENERGY_SOURCE_TYPE) heatingType heating_type String No heating type according to energy certificate(possible values can be found in [unit mutation](https://api-docs.everreal.co/endpoints/units/units-mutation) under HEATING_TYPE) condition condition String No condition of unit(possible values can be found in [enum mapping](https://api-docs.everreal.co/endpoints/units/units-mutation#enum-table-maps)under AMENITIES_CONDITION) qualityOfAmenities quality_of_amenities String No quality of amenities in unit(possible values can be found in [unit mutation](https://api-docs.everreal.co/endpoints/units/units-mutation) under QUALITY_OF_AMENITIES) amenitiesIncluded amenities_included String No amenities included in unit (comma separated and possible values can be found in [unit mutation](https://api-docs.everreal.co/endpoints/units/units-mutation) under AMENITIES_INCLUDED) ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-tenant-file-structure)Recommended Tenant File Structure The tenants module contains information about the tenants who occupy the units, such as name, lease term. Following are the field requirements. tenant_id must be unique and serves as the external identifier. Everreal FieldCSV FieldData TypeRequiredDefaultDescriptiontenantId tenant_id String Yes - external tenant_id reference unitId unit_id String Yes - external unit_id reference firstName first_name String Yes - tenant's first name lastName last_name String Yes - tenant's last name email email Email No - tenant's email basicRent basic_rent Decimal No - contract's basic rent utilityCosts utility_costs Decimal No - contract's utility costs heatingCosts heating_costs Decimal No - contract's heating cost totalRent total_rent Decimal Yes - contract's total rent deposit deposit Decimal Yes - contract's deposit contractStartDate contract_start_date String Yes - contract start date contractEndDate contract_end_date String No - contract end date ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#recommended-bank-account-file-structure)Recommended Bank Account File Structure The bank accounts module contains information about the bank accounts associated with owners, properties, or units. This file is **optional** and only required if you want to import bank account details into EverReal. Each bank account must be linked to at least one of the following IDs: owner_id, property_id, or unit_id. You can provide multiple IDs to associate an account with more than one entity. EverReal Field CSV Field Data Type RequiredDefaultDescriptionsaccountId account_id String Yes Unique identifier for the bank account accountName account_name String No Name of the account accountIban account_iban String Yes IBAN number of the account accountBic account_bic String Yes BIC code of the account accountBankName account_bank_name String No Name of the bank accountType account_type String No accountHolder account_holder String No Name of the account holder accountReferenceNumber account_reference_number String No Reference number associated with the account ownerId owner_id String No* External owner_id reference propertyId property_id String No* External property_id reference unitId unit_id String No* External unit_id reference * At least **one** of owner_id, property_id, or unit_id must be provided per row to establish a valid link. ### [](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data#sample-dataset-for-imports)Sample Dataset for imports This section contains sample files that can be used as a reference or can be used to import data to EverReal. The sample files are in a zip file that contains four CSV files: - owners.csv (Owner data) - objects.csv (Property data) - units.csv (Unit data) - tenants.csv (Tenant data) - bank_accounts.csv (Bank Account data, optional) Each CSV file has a header row that specifies the column names. The data in each file is related to the data in the other files by using unique identifiers. For example, the tenants.csv has a column called unit_id that is used to link the tenants to the unit. Please ensure that file names and CSV headers remain unchanged when modifying the data. Otherwise, the import will fail. You can use these sample files as a template to create your own data and import it to EverReal. Note: All CSV files must be saved in UTF-8 encoding. 6KB[ImportSample.zip](https://1594188794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgL3i0-8YP9K1HyrHy8%2Fuploads%2FU5XiTqGFyKTy5BgAaD8s%2FImportSample.zip?alt=media&token=e318cf5b-4b33-488d-b05e-8c1a307c9a1a)archiveDownload[Open](https://1594188794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgL3i0-8YP9K1HyrHy8%2Fuploads%2FU5XiTqGFyKTy5BgAaD8s%2FImportSample.zip?alt=media&token=e318cf5b-4b33-488d-b05e-8c1a307c9a1a)[PreviousImport Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers)[NextDebug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data Crawling: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports ============================================================ Title: Debug Imports | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)- [Connect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration) - [Import Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) - [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data) - [Debug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports) - [FAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Debugging is easier when you have a clear picture of what is happening in the system. That's why we provide you with detailed logs of every event related to import. You can access these logs by clicking on the event logs tab. There you can see the status, time, and source of each import event. [PreviousIdeal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)[NextFAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports Crawling: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq ============================================================ Title: FAQ | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process)- [Connect an Integration](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/connect-an-integration) - [Import Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) - [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data) - [Debug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports) - [FAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? **Which system is the Single Source of Truth?** To avoid discrepancies and allow consistent data depending on what's the core business of the partners software there needs to be on Single Source of Truth. For e.g. if there is being integrated an ERP system with EverReal the SSoT is the ERP system. **With what frequency will the data be transferred?** How often will data be imported should be clarified already from the beginning. The recommended frequency is once a day for data which is not changing that often as for e.g. terminations of contracts. A real time synchronisation of master data won't be supported. In case there is a valid reason a real time synchronisation should be considered EverReal should have a detailed overview provided with it. **Does the integration aim to be bi-directional?** For bi-directional integrations there should be a documentation what possibilities are provided by the partners software. This should be clear before the integration start. **Is a detailed description of goals & time plan available?** A detailed description of the integration goals should be provided to EverReal after deciding on the integration type (API or CSV files) with all the required fields. [PreviousDebug Imports](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/debug-imports)[NextData import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq Crawling: https://api-docs.everreal.co/how-to-guide/master-data ============================================================ Title: Data import via GraphQL | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide)- [EverReal Data Import Process](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process) - [Data import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To understand how authentication works in EverReal, see the [Authentication page](https://api-docs.everreal.co/master). For importing master data to EverReal it is required to keep the following order as shown in the chart: This chart shows the recommended data import flow**1.** First, the owners should be created/imported by using the following endpoint: [Owners Mutation](https://api-docs.everreal.co/endpoints/owners/owners-mutation). **2.** Once the import is finalised for the owners the next endpoint which should be used is [Property groups](https://api-docs.everreal.co/endpoints/property-groups). Creating Property groups is recommended but it's not necessary or a precondition for creating properties. If you want to bulk inherit descriptions (for e.g. amenities, location) to several properties it's recommended to create them. **3.** In the next step the properties should be created by using the following endpoint: [Property Mutation](https://api-docs.everreal.co/endpoints/properties/properties-mutation). The following checklist provides information about creating properties. The checklist summarizes the overall areas which might cause issues. - Address information is split in street, street number, zip code and city - Avoid having additional information in address information (e.g. in street number "Hinterhaus") - No duplicate properties --> Multiple properties with the same address information are not possible - Properties are not property groups. Properties should be broken down to the building entrance (Hauseingang) for explicit assignment 4. Going further in the following step [Units Mutation](https://api-docs.everreal.co/endpoints/units/units-mutation), units can be created and within creation assigned to associated property. Please consider the following when creating units: - For UnitInput {name:} we would recommend to insert the value for unit location for e.g. 1. OG links - For UnitInput {mainStorage:} the value can be set to TRUE or FALSE if the information is not available - For UnitInput {floorNo:} we need data format integer, in most of the ERP-systems the location of the unit is available for e.g. EG, 2. OG mitte etc. Therefore floorNo could be extracted from this information. This is required for generating the stacking plan in EverReal, as shown in the screenshot. Stacking Plan in EverReal1. The next step is [Tenants Mutation](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation), where tenants can be created and within creation assigned to associated units. As a result of the tenants import, the unit status is being automatically updated from EverReal. 1. Contract start date is in the past and there is no contract end date: unit status is leased 2. Contract start date is in the future: unit status is vacant, re-leased 3. Contract start date is either in the past or in the future but there is a contract end date in future: unit status is terminated 2. Optional final step: Bank accounts Mutation If you wish to import bank account data, use the Bank accounts Mutation after all core entities have been created. - Each bank account must be linked to at least one of the following IDs: owner_id, property_id, or unit_id. You can associate a single bank account with multiple entities if needed.In the screenshot below, you can see an example of bank accounts linked to an owner. These are visible in EverReal under: _Contacts → Owners → *select an owner* → Bank accounts tab_ Bank account linked to an owner [PreviousFAQ](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/faq)[NextEndpoints](https://api-docs.everreal.co/endpoints)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/how-to-guide/master-data Crawling: https://api-docs.everreal.co/endpoints ============================================================ Title: Endpoints | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ### [](https://api-docs.everreal.co/endpoints#interactive-playground)Interactive Playground To interact with data, we provide [GraphQL endpoint](https://graphql.org/learn/) where you can customize the response based on query payload. To use EverReal playground is required to provide the Bearer token, following was done in previous image. Accessing EverReal playground you can run queries and mutations. Open your browser and access https://{custom_subdomain}.everreal.co/api/reporting/graphql Guilde to interactive playgroundRefer below entities to access data [](https://api-docs.everreal.co/endpoints/account-users-members)Users [](https://api-docs.everreal.co/endpoints/owners)Owners [](https://api-docs.everreal.co/endpoints/property-groups)Property Group [](https://api-docs.everreal.co/endpoints/properties)Properties [](https://api-docs.everreal.co/endpoints/units)Units [](https://api-docs.everreal.co/endpoints/listing)Listings [](https://api-docs.everreal.co/endpoints/candidates)Candidates [](https://api-docs.everreal.co/endpoints/messages)Messages [](https://api-docs.everreal.co/endpoints/contact-activites)Contact Activities [](https://api-docs.everreal.co/endpoints/tenants)Tenants [](https://api-docs.everreal.co/endpoints/contract)Contracting [PreviousData import via GraphQL](https://api-docs.everreal.co/how-to-guide/master-data)[NextAccount users / members](https://api-docs.everreal.co/endpoints/account-users-members)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints Crawling: https://api-docs.everreal.co/endpoints/account-users-members ============================================================ Title: Account users / members | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [GraphQL Endpoint](https://api-docs.everreal.co/endpoints/account-users-members#graphql-endpoint) - [GraphQL endpoint to perform user operations](https://api-docs.everreal.co/endpoints/account-users-members#graphql-endpoint-to-perform-user-operations) - [Account user Query](https://api-docs.everreal.co/endpoints/account-users-members#account-user-query) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/account-users-members#graphql-endpoint)GraphQL Endpoint ## [](https://api-docs.everreal.co/endpoints/account-users-members#graphql-endpoint-to-perform-user-operations)GraphQL endpoint to perform user operations POST https://{custom_subdomain}.everreal.co/api/reporting/graphql Body of the request should follow GraphQL mutation structure like mutation { mutationName(input: {MutationNameInput!}) { MutationNamePayload } } ### [](https://api-docs.everreal.co/endpoints/account-users-members#account-user-query)Account user Query To query an user from Everreal use user query cURLSchemaCopyGET http://{custom_subdomain}.everreal.co/api/reporting/graphql --header 'Authorization: Bearer eyJhbGci...' {"query":"..."}Copytype User { id: String email: String firstName: String lastName: String profilePicture: IFile companyUser: companyUser } type companyUser { companyId: String } type Query { users(input: UserFilterListPaging): [User] } input UserFilterListPaging { filter: UserFilter paging: GraphPaging sort: GraphSorting } input UserFilter { id: String email: String } Below we are providing a full example how to get a user by email GraphQLcURLJavascriptCopyquery { users(input: { paging: { take: 10, skip: 0 }, filter: { email: "email@domain.co" } }) { id email } }Copycurl --location --request POST 'http://{subdomain}.everreal.co/api/reporting/graphql' \ --header 'Authorization: Bearer ....' \ --header 'Content-Type: application/json' \ --header 'Cookie: accept-language=de-DE' \ --data-raw '{"query":"query {\r\n users(input: { paging: { take: 10, skip: 0 }, filter: { email: \"email@domain.co\" } }) {\r\n id\r\n email\r\n }\r\n}","variables":{}}'Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ..."); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Cookie", "accept-language=de-DE"); var graphql = JSON.stringify({ query: "query {\r\n users(input: { paging: { take: 10, skip: 0 }, filter: { email: \"email@domain.co\" } }) {\r\n id\r\n email\r\n }\r\n}", variables: {} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("http://{subdomain}.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));[PreviousEndpoints](https://api-docs.everreal.co/endpoints)[NextOwners](https://api-docs.everreal.co/endpoints/owners)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/account-users-members Crawling: https://api-docs.everreal.co/endpoints/owners ============================================================ Title: Owners | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners)- [Owners Query](https://api-docs.everreal.co/endpoints/owners/owners-query) - [Owners Mutation](https://api-docs.everreal.co/endpoints/owners/owners-mutation) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [GraphQL Endpoint](https://api-docs.everreal.co/endpoints/owners#graphql-endpoint) - [GraphQL endpoint to perform owner operations](https://api-docs.everreal.co/endpoints/owners#graphql-endpoint-to-perform-owner-operations) Was this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use GraphQL, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)[](https://api-docs.everreal.co/endpoints/owners/owners-query)Owner Query [](https://api-docs.everreal.co/endpoints/owners/owners-mutation)Owner Mutation ### [](https://api-docs.everreal.co/endpoints/owners#graphql-endpoint)GraphQL Endpoint ## [](https://api-docs.everreal.co/endpoints/owners#graphql-endpoint-to-perform-owner-operations)GraphQL endpoint to perform owner operations POST https://{custom_subdomain}.everreal.co/api/reporting/graphql Body of the request should follow GraphQL mutation structure like mutation { mutationName(input: {MutationNameInput!}) { MutationNamePayload } } [PreviousAccount users / members](https://api-docs.everreal.co/endpoints/account-users-members)[NextOwners Query](https://api-docs.everreal.co/endpoints/owners/owners-query)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/owners Crawling: https://api-docs.everreal.co/endpoints/owners/owners-query ============================================================ Title: Owners Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners)- [Owners Query](https://api-docs.everreal.co/endpoints/owners/owners-query) - [Owners Mutation](https://api-docs.everreal.co/endpoints/owners/owners-mutation) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ### [](https://api-docs.everreal.co/endpoints/owners/owners-query#introduction)Introduction Our owner query will get you the list of owners from the respective company. We provides ability to filter the owner by externalId and fullSearch over firstName, lastName and email. Please make sure the paging option is used to fetch more items. To understand what is necessary and how to use GraphQL, on master data page we explain what is necessary to do **Query** Copytype Query { owners(input: OwnersFilterListPaging): [Owner] }**Schema** Copytype Owner { id: String externalId: String email: String firstName: String lastName: String fullName: String companyName: String address: Address bankInformation: OwnerBankIformation bankDepositInformation: OwnerBankDepositInformation customFieldValues: [CustomFieldValue] company: Company } type Address { streetName: String streetNumber: String zipCode: String city: String country: String } type OwnerBankDepositInformation { iban: String bic: String bankName: String accountHolderName: String } type OwnerBankIformation { bankName: String bankAddress: String bic: String iban: String } type CustomFieldValue { key: String! value: JSON } type Company { id: String name: String partnerId: String } input OwnersFilterListPaging { filter: OwnersFilter paging: GraphPaging sort: GraphSorting } input OwnersFilter { id: String externalId: String companyId: String fullSearch: String updatedAt: IDateRange } input GraphPaging { skip: Int take: Int } input GraphSorting { fieldName: String direction: String }_**Examples of Owner Query**_ GraphQLCopy{ owners( input: { filter: { externalId: "iE-32" } paging: { skip: 0, take: 50 } } ) { id email firstName lastName address { city } bankInformation { iban } } } [PreviousOwners](https://api-docs.everreal.co/endpoints/owners)[NextOwners Mutation](https://api-docs.everreal.co/endpoints/owners/owners-mutation)Last updated 47 minutes ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/owners/owners-query Crawling: https://api-docs.everreal.co/endpoints/owners/owners-mutation ============================================================ Title: Owners Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners)- [Owners Query](https://api-docs.everreal.co/endpoints/owners/owners-query) - [Owners Mutation](https://api-docs.everreal.co/endpoints/owners/owners-mutation) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Mutation Types](https://api-docs.everreal.co/endpoints/owners/owners-mutation#mutation-types) - [Schema Definition](https://api-docs.everreal.co/endpoints/owners/owners-mutation#schema-definition) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/owners/owners-mutation#mutation-types)Mutation Types Mutations are responsible to insert or update a specific register, the operation insert or update is defined by **externalId**, in case this owner was imported previously, this mutation will updated the resource, otherwise will create the property. Copytype Mutation { upsertOwner(owner:OwnerInput!) deleteOwner(externalId: String!) }Here are details on the capabilities of different mutations - The upsertOwner mutation is used to create or update an owner in Everreal system and owners added to the system cannot be modified by Everreal and if needs to be modified it should be done via the same endpoint itself. - The deleteOwner mutation is used to delete the owner relation with the external integration source, doing this will not delete the owner but instead it will remain as a detached owner from integration and can be modified using Everreal. ### [](https://api-docs.everreal.co/endpoints/owners/owners-mutation#schema-definition)Schema Definition items with **!**notation are required Copyinput OwnerInput { meta: MetaInformation! externalOwnerId: String! #externalId by which the owner is identified firstName: String! lastName: String! companyName: String email: String! phoneNo: String address: PersonalAddress bankDepositInformation: BankDepositInformation bankInformation: BankIformation customFieldValues: [CustomFieldValueInput] } input PersonalAddress { streetName: String streetNumber: String zipCode: String city: String country: String } input BankDepositInformation { iban: String bic: String bankName: String accountHolderName: String } input BankIformation { bankName: String bankAddress: String bic: String iban: String } input MetaInformation { source: String! # source should be the integration source, so logo is visible in everreal }Below we are providing a full example how to create or update an owner, all this information is not required, only the ones that was using **!**notation previously. graphQLJavaScriptCopymutation { upsertOwner( owner: { meta: { source: "INTEGRATION_SOURCE" } externalOwnerId: "91001+002242" firstName: "Ivana" lastName: "Maric" email: "ivana.maric@everreal.com" companyName: "Everreal Gmbh" phoneNo: "+49 123 1231 1237" address: { streetName: "Villenallee" streetNumber: "21" zipCode: "40211" city: "Düsseldorf" country: "DE" } } ) {id} }Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); var graphql = JSON.stringify({ query: "mutation {\r\n upsertOwner(\r\n owner: {\r\n meta: { source: \"INTEGRATION_SOURCE\" }\r\n externalOwnerId: \"91001+002242\"\r\n firstName: \"Ivana\"\r\n lastName: \"Maric\"\r\n email: \"ivana.maric@everreal.com\"\r\n companyName: \"Everreal Gmbh\"\r\n phoneNo: \"+49 123 1231 1237\"\r\n address: {\r\n streetName: \"Villenallee\"\r\n streetNumber: \"21\"\r\n zipCode: \"40211\"\r\n city: \"Düsseldorf\"\r\n country: \"DE\"\r\n }\r\n }\r\n ) {\r\n id\r\n }\r\n}\r\n\r\n", variables: {} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("http://{subdomain}.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error))[PreviousOwners Query](https://api-docs.everreal.co/endpoints/owners/owners-query)[NextProperty Groups](https://api-docs.everreal.co/endpoints/property-groups)Last updated 16 hours ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/owners/owners-mutation Crawling: https://api-docs.everreal.co/endpoints/property-groups ============================================================ Title: Property Groups | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups)- [Property Groups Query](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query) - [Property Group Mutation](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [GraphQL Endpoint](https://api-docs.everreal.co/endpoints/property-groups#graphql-endpoint) - [GraphQL endpoint to perform property operations](https://api-docs.everreal.co/endpoints/property-groups#graphql-endpoint-to-perform-property-operations) Was this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use GraphQL, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)### [](https://api-docs.everreal.co/endpoints/property-groups#graphql-endpoint)GraphQL Endpoint ## [](https://api-docs.everreal.co/endpoints/property-groups#graphql-endpoint-to-perform-property-operations)GraphQL endpoint to perform property operations POST https://{custom_subdomain}.everreal.co/api/reporting/graphql Body of the request should follow GraphQL mutation structure like mutation { mutationName(input: {MutationNameInput!}) { MutationNamePayload } } [PreviousOwners Mutation](https://api-docs.everreal.co/endpoints/owners/owners-mutation)[NextProperty Groups Query](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/property-groups Crawling: https://api-docs.everreal.co/endpoints/property-groups/property-groups-query ============================================================ Title: Property Groups Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups)- [Property Groups Query](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query) - [Property Group Mutation](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query#introduction) - [Property Group Query](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query#property-group-query) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query#introduction)**Introduction** Our property group query will get you the list of owners from the respective company. We provides ability to filter the property group query by externalId and fullSearch over propertyGroup name. Please make sure the paging option is used to fetch more items. ### [](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query#property-group-query)Property Group Query To query a property group from Everreal use propertyGroups query Copytype Query { propertyGroups(input: PropertyGroupFilterListPaging): [PropertyGroup] }**Schema** Copytype PropertyGroup { id: String externalId: String name: String createdAt: DateTime updatedAt: DateTime descriptions: PropertyGroupDescription properties: [PartialProperty] } type PartialProperty { id: String objectId: String name: String category: String subtype: String type: String } input PropertyGroupDescriptionInput { object: String amenities: String location: String other: String } input PropertyGroupFilter { id: String externalId: String companyId: String fullSearch: String } input GraphPaging { skip: Int take: Int } input GraphSorting { fieldName: String direction: String }_**Example for property group query**_ GraphQLCopy{ propertyGroups( input: { filter: { externalId: "iPG-32" }, paging: { skip: 0, take: 10 } } ) { name externalId properties { id objectId name category subtype type } } }[PreviousProperty Groups](https://api-docs.everreal.co/endpoints/property-groups)[NextProperty Group Mutation](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation)Last updated 9 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/property-groups/property-groups-query Crawling: https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation ============================================================ Title: Property Group Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups)- [Property Groups Query](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query) - [Property Group Mutation](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Mutation Types](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation#mutation-types) - [Schema Definition](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation#schema-definition) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation#mutation-types)Mutation Types **upsertPropertyGroup**: Mutation is responsible for inserting or updating a specific register, the operation insert or update is defined by **externalId**, in case this property was imported previously, this mutation will updated the resource, otherwise will create the property. Copytype Mutation { upsertPropertyGroup(propertyGroup: PropertyGroupInput!): PropertyGroup! }Here are details on the capabilities of different mutations - The upsertPropertyGroup the mutation is used to create or update a property group in the EverReal system and property added to the system cannot be modified by Everreal and if needs to be modified it should be done via the same endpoint itself. ### [](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation#schema-definition)Schema Definition items with **!**notation are required Copyinput PropertyGroupInput { name: String externalPropertyGroupId: String! descriptions: PropertyGroupDescriptionInput } input PropertyGroupDescriptionInput { object: String amenities: String location: String other: String } externalPropertyGroupId is required field, this is the key or the id which is used by the 3d party system(data synchronize between 3rd party) Below we are providing a full example how to create or update a property, all this information is not required, only the ones that was using **!**notation previously. graphQLJavaScriptCopymutation { upsertPropertyGroup( propertyGroup: { name: "Ray - PG1" externalPropertyGroupId: "RPG-1" descriptions:{ object: "Sample - Object" amenities: "Sample - Amenities" location: "Sample - Location" other: "Sample - Other" } } ) { id } }Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); var graphql = JSON.stringify({ query: "mutation {\n upsertPropertyGroup(\n propertyGroup: {\n name: \"Ray - PG1\"\n externalPropertyGroupId: \"RPG-1\"\n descriptions:{\n object: \"Sample - Object\"\n amenities: \"Sample - Amenities\"\n location: \"Sample - Location\"\n other: \"Sample - Other\"\n }\n }\n ) { id }\n}", variables: {} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("https://acme-qa.everreal-dev.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));[PreviousProperty Groups Query](https://api-docs.everreal.co/endpoints/property-groups/property-groups-query)[NextProperties](https://api-docs.everreal.co/endpoints/properties)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation Crawling: https://api-docs.everreal.co/endpoints/properties ============================================================ Title: Properties | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties)- [Properties Query](https://api-docs.everreal.co/endpoints/properties/properties-query) - [Properties Mutation](https://api-docs.everreal.co/endpoints/properties/properties-mutation) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [GraphQL Endpoint](https://api-docs.everreal.co/endpoints/properties#graphql-endpoint) - [GraphQL endpoint to perform property operations](https://api-docs.everreal.co/endpoints/properties#graphql-endpoint-to-perform-property-operations) Was this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use GraphQL, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)### [](https://api-docs.everreal.co/endpoints/properties#graphql-endpoint)GraphQL Endpoint ## [](https://api-docs.everreal.co/endpoints/properties#graphql-endpoint-to-perform-property-operations)GraphQL endpoint to perform property operations POST https://{custom_subdomain}.everreal.co/api/reporting/graphql Body of the request should follow GraphQL mutation structure like mutation { mutationName(input: {MutationNameInput!}) { MutationNamePayload } } [PreviousProperty Group Mutation](https://api-docs.everreal.co/endpoints/property-groups/property-group-mutation)[NextProperties Query](https://api-docs.everreal.co/endpoints/properties/properties-query)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/properties Crawling: https://api-docs.everreal.co/endpoints/properties/properties-query ============================================================ Title: Properties Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties)- [Properties Query](https://api-docs.everreal.co/endpoints/properties/properties-query) - [Properties Mutation](https://api-docs.everreal.co/endpoints/properties/properties-mutation) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/properties/properties-query#introduction) - [Property Group Query](https://api-docs.everreal.co/endpoints/properties/properties-query#property-group-query) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/properties/properties-query#introduction)**Introduction** Our property query will get you the list of properties from the respective company. We provides ability to filter the property query by externalId, propertyId, ownerId, propertyGroupId and fullSearch over property name. Please make sure the paging option is used to fetch more items. ### [](https://api-docs.everreal.co/endpoints/properties/properties-query#property-group-query)Property Group Query To query a property group from Everreal use properties query Copytype Query { properties(input: PropertiesFilterListPaging): [Property] }**Schema** Copyinput PropertiesFilterListPaging { filter: PropertiesFilter paging: GraphPaging sort: GraphSorting } input PropertiesFilter { id: String companyId: String propertyId: String @deprecated(reason: "propertyId is deprecated. Use id instead.") externalId: String propertyGroupId: String ownerId: String fullSearch: String updatedAt: IDateRange } input IDateRange { from: String to: String } input GraphPaging { skip: Int take: Int } input GraphSorting { fieldName: String direction: String } type Property { id: String objectId: String externalId: String name: String category: String subtype: String type: String ownershipType: String fullAddress: String ownerId: String yearBuilt: Int noOfStories: Int createdAt: DateTime updatedAt: DateTime company: Company address: Address descriptions: PropertyDescription owner: Owner listings: [Listing] units: [Unit] group: PropertyGroup responsibilityType: PROPERTY_RESPONSIBILITY_TYPE responsibleUserId: String responsibleUser: ResponsibleUser } type ResponsibleUser { id: String email: String firstName: String lastName: String } type Company { id: String name: String partnerId: String listings: [Listing] } type Address { street: String number: String zip: String city: String country: String location: GeoLocation } type Listing { id: String title: String type: String companyId: String listingResponsible: User contractDetails: ListingContractDetails coverPicture: IFile pictures: [IFile] documents: [IFile] floorplans: [IFile] company: Company property: Property unit: Unit createdAt: DateTime updatedAt: DateTime } type Unit { id: String objectId: String name: String category: String type: String subtype: String leasingStatuses: UnitLeasingStatuses availability: [Availability] leasingStatusEnum: String leasingStatusesEnum: [String] floorNumber: Float surface: Float livingSurface: Float hasMainStorage: Boolean rooms: UnitRooms owner: Owner property: Property createdAt: DateTime updatedAt: DateTime } type PropertyDescription { object: String amenities: String location: String other: String }_**Example for property Query**_ GraphQLCopy{ properties( input: { filter: { externalId: "IE-U-32" } paging: { skip: 0, take: 10 } } ) { id name responsibleUser { id email } objectId category subtype type ownerId yearBuilt noOfStories units { id } group { name } responsibilityType responsibleUser { email } } } [PreviousProperties](https://api-docs.everreal.co/endpoints/properties)[NextProperties Mutation](https://api-docs.everreal.co/endpoints/properties/properties-mutation)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/properties/properties-query Crawling: https://api-docs.everreal.co/endpoints/properties/properties-mutation ============================================================ Title: Properties Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties)- [Properties Query](https://api-docs.everreal.co/endpoints/properties/properties-query) - [Properties Mutation](https://api-docs.everreal.co/endpoints/properties/properties-mutation) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Mutation Types](https://api-docs.everreal.co/endpoints/properties/properties-mutation#mutation-types) - [Schema Definition](https://api-docs.everreal.co/endpoints/properties/properties-mutation#schema-definition) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/properties/properties-mutation#mutation-types)Mutation Types Mutations are responsible to insert or update a specific register, the operation insert or update is defined by **externalId**, in case this property was imported previously, this mutation will updated the resource, otherwise will create the property. Copytype Mutation { upsertProperty(property: PropertyInput!) deleteProperty(externalId: String!) }Here are details on the capabilities of different mutations - The upsertProperty mutation is used to create or update a property in Everreal system and property added to the system cannot be modified by Everreal and if needs to be modified it should be done via the same endpoint itself. - The deleteProperty mutation is used to delete the property relation with the external integration source, doing this will not delete the property but instead it will remain as a detached property from integration and can be modified using Everreal. ### [](https://api-docs.everreal.co/endpoints/properties/properties-mutation#schema-definition)Schema Definition items with **!**notation are required Copyinput PropertyInput { meta: MetaInformation! address: AddressInput! id: String #you can pass the id to change the externalId of the property externalPropertyId: String! #externalId by which the property will be identified ownerId: String #when ownershipType=INDIVIDUAL you should either pass externalOwnerId or ownerId where ownerId is Everreal generated Id externalOwnerId: String #when ownershipType=INDIVIDUAL you should either pass externalOwnerId or ownerId where ownerId is Everreal generated I name: String! type: PROPERTY_TYPE! subtype: PROPERTY_TYPE! category: PROPERTY_CATEGORY! noOfStories: Int # The total number of floors of the building yearBuilt: Int ownershipType: PROPERTY_OWNERSHIP_TYPE! #when passed as MULTIPLE you dont need to pass ownerId or externalOwnerId responsibilityType: PROPERTY_RESPONSIBILITY_TYPE responsibleUserId: String propertyGroupId: String externalPropertyGroupId: String descriptions: PropertyDescriptionInput } input AddressInput { streetName: String! streetNumber: String! zipCode: String! city: String! country: String! location: GeoLocationInput placeId: String } input PropertyDescriptionInput { object: String amenities: String location: String other: String } input GeoLocationInput { lat: Float! lng: Float! } input MetaInformation { source: String! } If you don't have a value for a required field that is an enum, then pass the default value, for PROPERTY_OWNERSHIP_TYPE if passed INDIVIDUAL then it should contain ownerId. When Owner or ResponsibleUser is changed in property the value will be inherited to the units attached to property and owner, unitResponsible will be updated respectively. Also, When OwnershipType and ResponsibilityUserType is changed to MULTIPLE,the value of the owner and responsible users will not be cleared in unit level instead retains previous value. EnumDefaultPossible ValuesPROPERTY_TYPE BUILDING BUILDING | LAND PROPERTY_CATEGORY RESIDENTIAL_AND_COMMERCIAL RESIDENTIAL | COMMERCIAL | RESIDENTIAL_AND_COMMERCIAL PROPERTY_OWNERSHIP_TYPE MULTIPLE INDIVIDUAL | MULTIPLE PROPERTY_RESPONSIBILITY_TYPE MULTIPLE INDIVIDUAL| MULTIPLE Below we are providing a full example how to create or update a property, all this information is not required, only the ones that was using **!**notation previously. graphQLJavaScriptCopymutation { upsertProperty( property: { meta: { source: "INTEGRATION_SOURCE" } name: "Munich Appartment" type: BUILDING externalPropertyId: "9098/501" ownerId: "b8559500-bb35-11ec-a64e-4b00ff3d25d5" externalOwnerId: "981/2"d category: RESIDENTIAL subtype: BUILDING noOfStories: 10 address: { city: "Ludwigshafen a. Rhein" country: "DE" streetNumber: "44 - 68" streetName: "Hoher Weg" zipCode: "67067" location: { lat: 52.5705570, lng: 6.14847399999933 } } ownershipType: INDIVIDUAL } ) {id} }Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); var graphql = JSON.stringify({ query: 'mutation {\r\n upsertProperty(\r\n property: {\r\n meta: { source: "INTEGRATION_SOURCE" }\r\n name: "Hohe 12"\r\n type: BUILDING\r\n externalPropertyId: "9098/50"\r\n category: RESIDENTIAL\r\n subtype: BUILDING\r\n address: {\r\n city: "Ludwigshafen a. Rhein"\r\n country: "DE"\r\n streetNumber: "44 - 68"\r\n streetName: "Hoher Weg"\r\n zipCode: "67067"\r\n location: { lat: 52.5705570, lng: 6.14847399999933 }\r\n }\r\n ownershipType: MULTIPLE\r\n }\r\n ) {\r\n id\r\n }\r\n}', variables: {}, }); var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("http://{subdomain}.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));[PreviousProperties Query](https://api-docs.everreal.co/endpoints/properties/properties-query)[NextUnits](https://api-docs.everreal.co/endpoints/units)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/properties/properties-mutation Crawling: https://api-docs.everreal.co/endpoints/units ============================================================ Title: Units | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units)- [Units Query](https://api-docs.everreal.co/endpoints/units/units-query) - [Units Mutation](https://api-docs.everreal.co/endpoints/units/units-mutation) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [GraphQL Endpoint](https://api-docs.everreal.co/endpoints/units#graphql-endpoint) - [GraphQL endpoint to perform unit operations](https://api-docs.everreal.co/endpoints/units#graphql-endpoint-to-perform-unit-operations) Was this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use GraphQL, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)### [](https://api-docs.everreal.co/endpoints/units#graphql-endpoint)GraphQL Endpoint ## [](https://api-docs.everreal.co/endpoints/units#graphql-endpoint-to-perform-unit-operations)GraphQL endpoint to perform unit operations POST https://{custom_subdomain}.everreal.co/api/reporting/graphql Body of the request should follow GraphQL mutation structure like mutation { mutationName(input: {MutationNameInput!}) { MutationNamePayload } } [PreviousProperties Mutation](https://api-docs.everreal.co/endpoints/properties/properties-mutation)[NextUnits Query](https://api-docs.everreal.co/endpoints/units/units-query)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/units Crawling: https://api-docs.everreal.co/endpoints/units/units-query ============================================================ Title: Units Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units)- [Units Query](https://api-docs.everreal.co/endpoints/units/units-query) - [Units Mutation](https://api-docs.everreal.co/endpoints/units/units-mutation) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/units/units-query#introduction) - [Unit Query](https://api-docs.everreal.co/endpoints/units/units-query#unit-query) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/units/units-query#introduction)**Introduction** Our unit query will get you the list of units from the respective company. We provides ability to filter the unit query by externalId, propertyId, ownerId, propertyGroupId, leasingStatus etc. Please make sure the paging option is used to fetch more items. ### [](https://api-docs.everreal.co/endpoints/units/units-query#unit-query)Unit Query To query a property group from Everreal use units query Copytype Query { units(input: UnitsFilterListPaging): [Unit] }**Schema** Copyinput UnitsFilterListPaging { filter: UnitsFilter paging: GraphPaging sort: GraphSorting } input UnitsFilter { id: String companyId: String externalId: String propertyGroupId: String propertyId: String ownerId: String """ Full search in Unit [name, objectId] OR Property [address, name] """ fullSearch: String @deprecated(reason: "This will be removed, because 'leasingStatuses' should be used, which provides more flexibility.") leasingStatus: String """ Search by multiple leasing statuses at the time """ leasingStatuses: [FILTER_UNITS_LEASING_STATUSES] hasListing: Boolean updatedAt: IDateRange includeExternal: Boolean } input GraphPaging { skip: Int take: Int } input GraphSorting { fieldName: String direction: String } type Unit { id: String objectId: String externalId: String name: String category: String type: String subtype: String leasingStatuses: UnitLeasingStatuses leasingStatusCurrentlyLeased: Boolean statuses: AllUnitStatuses availability: [Availability] @deprecated(reason: "A unit can have multiple leasingStatuses, please switch to 'leasingStatusesEnum' property") leasingStatusEnum: FILTER_UNITS_LEASING_STATUSES leasingStatusesEnum: [FILTER_UNITS_LEASING_STATUSES] statusesEnum: [String] floorNumber: Float @deprecated('use floorNo instead') floorNo: Float surface: Float livingSurface: Float netFloorSurface: Float hasMainStorage: Boolean rooms: UnitRooms owner: Owner amenities: Amenities descriptions: UnitDescription unitResponsibleId: String unitResponsible: ResponsibleUser surcharges: Float currentRent: Float targetRent: Float availableFrom: DateTime onHoldStatus: Boolean onHoldReason: UNIT_ON_HOLD_REASON property: Property financingType: UNIT_FINANCING_TYPE createdAt: DateTime updatedAt: DateTime } type ResponsibleUser { id: String email: String firstName: String lastName: String } type UnitDescription { object: String amenities: String location: String other: String } type Amenities { amenitiesIncluded: [AMENITIES_INCLUDED] hasParking: Boolean parking: UnitParkingType qualityOfAmenities: QUALITY_OF_AMENITIES condition: AMENITIES_CONDITION lastRenovationYear: Int heatingType: HEATING_TYPE mainEnergySource: ENERGY_SOURCE_TYPE energyPerformanceCertificateAvailability: ENERGY_PERFORMANCE_CERTIFICATE_AVAILABILITY energyCertificateCreationDate: ENERGY_CERTIFICATE_CREATION_DATE buildingEnergyRatingType: BUILDING_ENERGY_RATING_TYPE thermalCharacteristic: Float energyConsumptionContainsWarmWater: Boolean energyEfficiencyClass: ENERGY_EFFICIENCY_CLASS hasLanCables: YES_NO_BYAPPOINTMENT hasAirConditioning: YES_NO_BYAPPOINTMENT floorType: COMMERCIAL_UNIT_FLOORTYPE goodsLiftLoad: Float floorLoad: Float supplyType: STORE_SUPPLY_TYPE powerSupplyLoad: Float craneRunwayLoad: Float } type Availability { from: DateTime } type UnitRooms { rooms: Float bedrooms: Float bathrooms: Float } type UnitLeasingStatuses { vacant: Boolean terminated: Boolean futureLeased: Boolean currentlyLeased: Boolean } enum UNIT_FINANCING_TYPE { PRIVATELY_FINANCED PUBLICLY_SUBSIDIZED } enum FILTER_UNITS_LEASING_STATUSES { LEASED TERMINATED VACANT FUTURE_LEASED ON_HOLD }_**Example for property Query**_ GraphQLCopy{ units( input: { filter: { externalId: "ER-P12-U-22" } paging: { skip: 0, take: 20 } } ) { id name unitResponsible { email firstName lastName } externalId category type subtype currentRent amenities { amenitiesIncluded qualityOfAmenities hasParking parking { type quantity } } } }[PreviousUnits](https://api-docs.everreal.co/endpoints/units)[NextUnits Mutation](https://api-docs.everreal.co/endpoints/units/units-mutation)Last updated 5 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/units/units-query Crawling: https://api-docs.everreal.co/endpoints/units/units-mutation ============================================================ Title: Units Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units)- [Units Query](https://api-docs.everreal.co/endpoints/units/units-query) - [Units Mutation](https://api-docs.everreal.co/endpoints/units/units-mutation) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Mutation Types](https://api-docs.everreal.co/endpoints/units/units-mutation#mutation-types) - [Schema Definition](https://api-docs.everreal.co/endpoints/units/units-mutation#schema-definition) - [Enum table maps](https://api-docs.everreal.co/endpoints/units/units-mutation#enum-table-maps) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/units/units-mutation#mutation-types)Mutation Types Mutations are responsible to insert or update a specific register, the operation insert or update is defined by **externalId**, in case this unit was imported previously, this mutation will updated the resource, otherwise will create the unit. Copytype Mutation { upsertUnit(unit: UnitInput): Unit deleteUnit(externalId: String): Boolean }Here are details on the capabilities of different mutations - The upsertUnit mutation is used to create or update a unit in Everreal system and unit added to the system cannot be modified by Everreal and if needs to be modified it should be done via the same endpoint itself. - The deleteUnit mutation is used to delete the unit relation with the external integration source, doing this will not delete the unit but instead it will remain as a detached unit from integration and can be modified using Everreal. ### [](https://api-docs.everreal.co/endpoints/units/units-mutation#schema-definition)Schema Definition items with **!**notation are required Copyinput UnitInput { externalUnitId: String! #externalId by which the unit will be identified propertyId: String! #propertyId by which the unit will be attached to. You have to either pass propertyId or externalpropertyId externalPropertyId: String! #externalPropertyId by which the unit will be attached to. You have t ownerId: String! #ownerId by which the unit will be attached to. You have to either pass ownerId or externalOwnerId externalOwnerId: String! #externalOwnerId by which the unit will be attached to. You have to either pass ownerId or externalOwnerId category: UNIT_CATEGORY! type: UNIT_TYPE! name: String subtype: UNIT_SUBTYPES! netFloorSurface: Float livingSurface: Float rooms: UnitRoomsInput mainStorage: Boolean! floorNo: Int! amenities: AmenitiesInput descriptions: IUnitDescriptionInput financingType: UNIT_FINANCING_TYPE! targetRent: Float surcharges: Float currentRent: Float availableFrom: Date # date in YYYY-MM-DD fromat lettingReadinessStatus: UNIT_LETTING_READINESS_STATUS lettingReadinessSubReason: UNIT_LETTING_READINESS_SUB_REASON unitResponsibleId: String meta: MetaInformation! } input UnitParkingTypeInput { type: PARKING_TYPES quantity: Int } input UnitRoomsInput { rooms: Float bathrooms: Float bedrooms: Float } input IUnitDescriptionInput { object: String amenities: String location: String other: String } input MetaInformation { source: String! } enum UNIT_ON_HOLD_REASON { FIRST_TIME_USE CONSTRUCTION_MEASURES OCCUPANCY_RIGHT INTERNAL_USE RESERVED OTHER } enum UNIT_FINANCING_TYPE { PRIVATELY_FINANCED PUBLICLY_SUBSIDIZED } enum AMENITIES_INCLUDED { BUILTIN_KITCHEN ELEVATOR GOODS_LIFT BALCONY_OR_TERRACE GUEST_TOILET GARDEN BASEMENT STEPLESS_ENTRY LIVING_QUALIFICATION_CERTIFICATE SUITABLE_FOR_SHARED_APARTMENT SUITABLE_FOR_HOLIDAY CAFETERIA HIGH_VOLTAGE RAMP HYDRAULIC_RAMP TERRACE HAS_CRANE_RUNWAY } input AmenitiesInput { amenitiesIncluded: [AMENITIES_INCLUDED] hasParking: Boolean parking: UnitParkingType qualityOfAmenities: QUALITY_OF_AMENITIES condition: AMENITIES_CONDITION lastRenovationYear: Int heatingType: HEATING_TYPE mainEnergySource: ENERGY_SOURCE_TYPE energyPerformanceCertificateAvailability: ENERGY_PERFORMANCE_CERTIFICATE_AVAILABILITY energyCertificateCreationDate: ENERGY_CERTIFICATE_CREATION_DATE buildingEnergyRatingType: BUILDING_ENERGY_RATING_TYPE thermalCharacteristic: Float energyConsumptionContainsWarmWater: Boolean energyEfficiencyClass: ENERGY_EFFICIENCY_CLASS hasLanCables: YES_NO_BYAPPOINTMENT hasAirConditioning: YES_NO_BYAPPOINTMENT floorType: COMMERCIAL_UNIT_FLOORTYPE goodsLiftLoad: Float floorLoad: Float supplyType: STORE_SUPPLY_TYPE powerSupplyLoad: Float craneRunwayLoad: Float } type Amenities { amenitiesIncluded: [AMENITIES_INCLUDED] hasParking: Boolean parking: UnitParkingType qualityOfAmenities: QUALITY_OF_AMENITIES condition: AMENITIES_CONDITION lastRenovationYear: Int heatingType: HEATING_TYPE mainEnergySource: ENERGY_SOURCE_TYPE energyPerformanceCertificateAvailability: ENERGY_PERFORMANCE_CERTIFICATE_AVAILABILITY energyCertificateCreationDate: ENERGY_CERTIFICATE_CREATION_DATE buildingEnergyRatingType: BUILDING_ENERGY_RATING_TYPE thermalCharacteristic: Float energyConsumptionContainsWarmWater: Boolean energyEfficiencyClass: ENERGY_EFFICIENCY_CLASS hasLanCables: YES_NO_BYAPPOINTMENT hasAirConditioning: YES_NO_BYAPPOINTMENT floorType: COMMERCIAL_UNIT_FLOORTYPE goodsLiftLoad: Float floorLoad: Float supplyType: STORE_SUPPLY_TYPE powerSupplyLoad: Float craneRunwayLoad: Float } enum STORE_SUPPLY_TYPE { DIRECT_APPROACH NO_DIRECT_APPROACH CAR_APPROACH APPROACH_TO_THE_FRONT APPROACH_TO_THE_BACK FULL_TIME FORENOON NO_INFORMATION } enum ENERGY_SOURCE_TYPE { NO_INFORMATION GEOTHERMAL SOLAR_HEATING PELLET_HEATING GAS OIL DISTRICT_HEATING ELECTRICITY COAL ACID_GAS SOUR_GAS LIQUID_GAS STEAM_DISTRICT_HEATING WOOD WOOD_CHIPS COAL_COKE LOCAL_HEATING HEAT_SUPPLY BIO_ENERGY HYDRO_ENERGY ENVIRONMENTAL_THERMAL_ENERGY COMBINED_HEAT_AND_POWER_FOSSIL_FUELS COMBINED_HEAT_AND_POWER_RENEWABLE_ENERGY COMBINED_HEAT_AND_POWER_REGENERATIVE_ENERGY COMBINED_HEAT_AND_POWER_BIO_ENERGY } enum PARKING_TYPES { GARAGE OUTSIDE_PARKING_SPOT CARPORT DUPLEX PARKING_GARAGE UNDERGROUND_PARKING NO_INFORMATION } enum HEATING_TYPE { BLOCK_HEATING_STATION ELECTRIC_HEATING SELF_CONTAINED_CENTRAL_HEATING TELEHEATING FLOOR_HEATING GAS_HEATING WOOD_PELLET_HEATER NIGHT_STORAGE_HEATER STOVE_HEATING OIL_HEATING SOLAR_HEATING HEAT_PUMP CENTRAL_HEATING } enum QUALITY_OF_AMENITIES { LUXURIOUS UPSCALE NORMAL BASIC } ### [](https://api-docs.everreal.co/endpoints/units/units-mutation#enum-table-maps)Enum table maps **Field****sub_type****use the following table** UNIT_TYPEDefaultPossible ValuesAPARTMENT NO_INFORMATION NO_INFORMATION | APARTMENT | STUDIO | GROUND_FLOOR | TERRACE_APARTMENT | PENTHOUSE | MAISONETTE | LOFT | ROOM | HOUSE | ATTIC_FLOOR | SOUTERRAIN | MEZZANINE HOUSE NO_INFORMATION SINGLE_FAMILY_HOUSE | MID_TERRACE_HOUSE | END_TERRANCE_HOUSE | MULTI_FAMILY_HOUSE | BUNGALOW | FARMHOUSE | SEMIDETACHED_HOUSE | MANSION | TOWN_HOUSE | SPECIAL_REAL_ESTATE | NO_INFORMATION PARKING NO_INFORMATION GARAGE | OUTSIDE_PARKING_SPOT | CARPORT | DUPLEX | PARKING_GARAGE | UNDERGROUND_PARKING | NO_INFORMATION OFFICE OFFICE LOFT | STUDIO | OFFICE | OFFICE_FLOOR | OFFICE_CENTER | OFFICE_STORAGE_BUILDING | SURGERY | SURGERY_FLOOR | SURGERY_BUILDING | COMMERCIAL_CENTER | LIVING_AND_COMMERICAL_BUILDING | OFFICE_AND_COMMERICAL_BUILDING STORE STORE SHOWROOM_SPACE | SHOPPING_CENTER | FACTORY_OUTLET | DEPARTMENT_STORE | KIOSK | STORE | SELF_SERVICE_MARKET | SALES_AREA | SALES_HALL GASTRONOMY CAFE BAR_LOUNGE | CAFE | CLUB_DISCO | GUESTHOUSE | TAVERN | HOTEL | HOTEL_RESIDENCE | HOTEL_GARNI | PENSION | RESTAURANT | BUNGALOW INDUSTRY HALL SHOWROOM_SPACE | HALL | HIGH_LACK_STORAGE | INDUSTRY_HALL | COLD_STORAGE | MULTIDECK_CABINET_STORAGE | STORAGE_WITH_OPEN_AREA | STORAGE_AREA | STORAGE_HALL | SERVICE_AREA | SHIPPING_STORAGE | REPAIR_SHOP SPECIAL PURPOSE SPECIAL_ESTATE RESIDENCE | FARM | HORSE_FARM | VINEYARD | REPAIR_SHOP | LEISURE_FACILITY | SPECIAL_ESTATE | COMMERCIAL_CENTER | INDUSTRIAL_AREA **Field****UNIT_LETTING_READINESS_SUB_REASON****use the following table** UNIT_LETTING_READINESS_STATUSDefaultPossible ValuesLETTABLE_WITH_RENOVATION MINOR_RENOVATION | RENOVATION_2X_CAPEX | RENOVATION_EXCEEDS_2X_CAPEX | RENOVATION_EXCEEDS_3_YEARS_RENT NOT_LETTABLE NO_ACCESS | BLOCKED_BUILDING_CONDITION | BLOCKED_DUE_SALE | BLOCKED_REGULATORY | BLOCKED_STRATEGIC | RENTAL_PRICE_APPROVAL | RENTAL_AUTHORIZATION | FIRST_TIME_USE | CONSTRUCTION_MEASURES | OCCUPANCY_RIGHT | INTERNAL_USE | INTERNAL_USE_FOR_RENTAL_PURPOSE | RESERVED | OTHER UNKNOWN NOT_YET_ASSESSED **Other enum fields** ENUMDefaultPossible ValueUNIT_TYPE APARTMENT APARTMENT | HOUSE | PARKING | OFFICE | STORE | GASTRONOMY | INDUSTRY | SPECIAL_PURPOSE | LAND UNIT_CATEGORY RESIDENTIAL COMMERCIAL | RESIDENTIAL ENERGY_PERFORMANCE_CERTIFICATE_AVAILABILITY AVAILABLE_AT_VIEWING AVAILABLE | AVAILABLE_AT_VIEWING | NOT_REQUIRED ENERGY_CERTIFICATE_CREATION_DATE BEFORE_01_MAY_2014 | FROM_01_MAY_2014 BUILDING_ENERGY_RATING_TYPE ENERGY_REQUIRED | ENERGY_CONSUMPTION ENERGY_EFFICIENCY_CLASS NO_INFORMATION | A_PLUS | A | B | C | D | E | F | G | H YES_NO_BYAPPOINTMENT NO_INFORMATION YES | NO | BY_APPOINTMENT | NO_INFORMATION COMMERCIAL_UNIT_FLOORTYPE NO_INFORMATION CONCRETE | EPOXY_RESIN | TILES | PLANKS | LAMINATE | PARQUET | PVC | CARPET | ANTISTATIC_FLOOR | OFFICE_CARPET | STONE | CUSTOMIZABLE | WITHOUT | NO_INFORMATION AMENITIES_CONDITION WELL_KEPT FIRST_TIME_USE | FIRST_TIME_USE_AFTER_REFURBISHMENT | AS_GOOD_AS_NEW | REFURBISHED | UPGRADED | FULLY_RENOVATED | WELL_KEPT | IN_NEED_OF_RENOVATION | NEGOTIABLE | DILAPIDATED UNIT_LETTING_READINESS_STATUS LETTABLE_WITHOUT_ISSUES | LETTABLE_WITH_RENOVATION | NOT_LETTABLE | UNKNOWN Below we are providing a full example how to create or update a unit, all this information is not required, only the ones that was using **!**notation previously. graphQLJavaScriptCopy mutation { upsertUnit( unit: { meta: { source: "INTEGRATION_TYPE" } name: "Appartmert" externalUnitId: "910011000009" propertyId: "b7ecfa0c-6dfc-4236-abac-0a92d90ce032" externalOwnerId: "2255" category: RESIDENTIAL type: APARTMENT subtype: APARTMENT rooms: { bedrooms: 0 rooms: 4 } amenities:{ condition: FULLY_RENOVATED lastRenovationYear: 2012 qualityOfAmenities: LUXURIOUS, energyConsumptionContainsWarmWater: true energyEfficiencyClass: A_PLUS energyCertificateCreationDate: FROM_01_MAY_2014 hasLanCables: YES } descriptions: { object: "Property Group 01: child-rich parts of the city.ss", amenities: "Property Group 01: Completely furnished with high-quality custom-made fittings", location: "Property Group 01: Langenhagen The city of Langenhagen connects directly to the settlement area of ​​Hanover in the north.", other: "Property Group 01: See more Infosys at www.myclimate.org and in Kundenportal." } } ) { id } }Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Cookie", "accept-language=de-DE"); var graphql = JSON.stringify({ query: "\r\nmutation {\r\n upsertUnit(\r\n unit: {\r\n meta: { source: \"INTEGRATION_TYPE\" }\r\n name: \"Appartmert\"\r\n externalUnitId: \"910011000009\"\r\n propertyId: \"b7ecfa0c-6dfc-4236-abac-0a92d90ce032\"\r\n externalOwnerId: \"2255\"\r\n category: RESIDENTIAL\r\n type: APARTMENT\r\n subtype: APARTMENT\r\n rooms: {\r\n bedrooms: 0\r\n rooms: 4\r\n }\r\n amenities:{\r\n condition: FULLY_RENOVATED\r\n lastRenovationYear: 2012\r\n qualityOfAmenities: \"LUXURIOUS\",\r\n energyConsumptionContainsWarmWater: true\r\n energyEfficiencyClass: A_PLUS\r\n energyCertificateCreationDate: FROM_01_MAY_2014\r\n hasLanCables: YES\r\n }\r\n descriptions: {\r\n object: \"Property Group 01: child-rich parts of the city.ss\",\r\n amenities: \"Property Group 01: Completely furnished with high-quality custom-made fittings\",\r\n location: \"Property Group 01: Langenhagen The city of Langenhagen connects directly to the settlement area of ​​Hanover in the north.\",\r\n other: \"Property Group 01: See more Infosys at www.myclimate.org and in Kundenportal.\"\r\n }\r\n }\r\n ) {\r\n id\r\n }\r\n}", variables: {} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("https://acme-qa.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));[PreviousUnits Query](https://api-docs.everreal.co/endpoints/units/units-query)[NextListing](https://api-docs.everreal.co/endpoints/listing)Last updated 1 month ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/units/units-mutation Crawling: https://api-docs.everreal.co/endpoints/listing ============================================================ Title: Listing | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing)- [Listing Query](https://api-docs.everreal.co/endpoints/listing/listing-query) - [Listing Mutation](https://api-docs.everreal.co/endpoints/listing/listing-mutation) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Important information](https://api-docs.everreal.co/endpoints/listing#important-information) - [Query](https://api-docs.everreal.co/endpoints/listing#query) - [Mutation](https://api-docs.everreal.co/endpoints/listing#mutation) - [Schema Definition](https://api-docs.everreal.co/endpoints/listing#schema-definition) Was this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page ### [](https://api-docs.everreal.co/endpoints/listing#important-information)Important information #### [](https://api-docs.everreal.co/endpoints/listing#amenities)Amenities Parking can have 2 values: - null if the listing does not have amenity "Has Parking" checked - {type, quality} if the listing has amenity "Has Parking" checked **Pictures and documents** There are 4 important document properties: {coverPicture,pictures,documents,floorPlans} The base path of pictures is formed of the baseUrl + "/" picture.resourcePath .The base url is [https://resources.everreal.co](https://api-docs.everreal.co/endpoints/listing#graphql) ### [](https://api-docs.everreal.co/endpoints/listing#query)Query To understand what is necessary and how to use GraphQl, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)Copytype Query { listings(input: ListingFilterListPaging): [Listing] avgListingActivity(input: AvgActivityFilter): AvgListingActivity listingCounts(input: ListingCountsFilter): ListingCounts } type AvgListingActivity { activeListings: Int } type ListingCounts { listingsMissingViewings: Int listingsMissingContracts: Int activeAndPublished: Int olderThan30Days: Int listingsInContracting: Int listingsContractingCompleted: Int listingsMoveinCompleted: Int } type Listing { id: String title: String type: String isArchived: Boolean isActive: Boolean companyId: String listingResponsible: User contractDetails: ListingContractDetails coverPicture: IFile pictures: [IFile] documents: [IFile] floorplans: [IFile] company: Company status: LISTING_STATUS amenities: ListingAmenities listingInformation: ListingInformation availableFrom: Date propertyId: String property: Property unitId: String unit: Unit descriptions: ListingDescription createdAt: DateTime updatedAt: DateTime } type ListingAmenities { amenitiesIncluded: [AMENITIES_INCLUDED] # See this type under units page parking: UnitParkingType # See this type under units page qualityOfAmenities: String condition: String lastRenovationYear: Int heatingType: String mainEnergySource: String energyPerformanceCertificateAvailability: ENERGY_PERFORMANCE_CERTIFICATE_AVAILABILITY energyCertificateCreationDate: ENERGY_CERTIFICATE_CREATION_DATE buildingEnergyRatingType: BUILDING_ENERGY_RATING_TYPE thermalCharacteristic: Float energyConsumptionContainsWarmWater: Boolean energyEfficiencyClass: ENERGY_EFFICIENCY_CLASS } type ListingDescription { object: String amenities: String location: String other: String } type ListingContractDetails { currency: String rent: Float totalMonthlyRent: Float parkingRent: Float deposit: Float heatingCostsIncluded: Boolean utilityCosts: Float heatingCosts: Float petsAllowed: String displayAmount: Float hasCommission: Boolean commission: String commissionNote: String commissionType: String } enum UNIT_TYPE { APARTMENT HOUSE PARKING OFFICE STORE GASTRONOMY INDUSTRY SPECIAL_PURPOSE LAN } enum LISTING_TYPE { RENT_APARTMENT SELL_APARTMENT RENT_SHORT_TERM_APARTMENT RENT_HOUSE SELL_HOUSE RENT_PARKING SELL_PARKING RENT_RESIDENTIAL_LAND SELL_RESIDENTIAL_LAND RENT_OFFICE SELL_OFFICE RENT_STORE SELL_STORE RENT_GASTRONOMY SELL_GASTRONOMY RENT_INDUSTRY SELL_INDUSTRY RENT_SPECIAL_PURPOSE SELL_SPECIAL_PURPOSE RENT_COMMERCIAL_LAND SELL_COMMERCIAL_LAND } enum LISTING_STATUS { OPEN_FOR_CANDIDATES OPEN_FOR_APPLICANTS CONTRACTING_STARTED CONTRACTING_COMPLETED MOVE_IN_COMPLETED IS_INACTIVE IS_ARCHIVED } enum CANDIDATE_SOURCE { APPLIED_EVERREAL MANUAL_EVERREAL_CANDIDATE MANUAL_EVERREAL_SCHEDULED MANUAL_EVERREAL_APPLICANT IMMOSCOUT24 WG_GESUCHT IMMOWELT IMMONET IVD24 NWZ OPENIMMO_GENERIC EBAY OFFLINE_CONTRACT } input ListingFilter { from: Date to: Date candidateSources: [CANDIDATE_SOURCE] companyId: String propertyGroupId: String propertyId: String ownerId: String listingId: String external: Boolean fullSearch: String isArchived: Boolean isActive: Boolean internalAdvertiseId: String availableFrom: Date externalPropertyId: String scoringTemplateId: String propertyCity: String propertyName: String propertyStreet: String listingType: LISTING_TYPE status: LISTING_STATUS responsibleFullName: String unitName: String unitId: String externalUnitId: String unitType: UNIT_TYPE priceMin: Float priceMax: Float roomsMin: Int roomsMax: Int surfaceMin: Int surfaceMax: Int livingSurfaceMin: Int livingSurfaceMax: Int heightMax: Int heightMin: Int listingResponsibleUserId: String projectId: String candidateEmail: String candidateIsWinner: Boolean } input ListingFilterListPaging { filter: ListingFilter paging: GraphPaging sort: GraphSorting } input ListingCountsFilter { userId: String companyId: String } Usage: GraphQLCURLJavascript**Query:** Copy query listingsQuery( $from: Date $to: Date $companyId: String $propertyId: String $propertyGroupId: String $ownerId: String $listingId: String $isArchived: Boolean $isActive: Boolean $fullSearch: String ) { listings( input: { paging: { take: 100, skip: 0 } filter: { from: $from to: $to companyId: $companyId propertyGroupId: $propertyGroupId propertyId: $propertyId ownerId: $ownerId listingId: $listingId isArchived: $isArchived isActive: $isActive fullSearch: $fullSearch } } ) { id title type isArchived isActive companyId amenities{ amenitiesIncluded qualityOfAmenities parking {type quantity} energyPerformanceCertificateAvailability energyCertificateCreationDate buildingEnergyRatingType thermalCharacteristic energyConsumptionContainsWarmWater energyEfficiencyClass } coverPicture { name resourceId resourcePath size type order isCoverPicture } pictures { name resourceId resourcePath size type order isCoverPicture } documents { name resourceId resourcePath size type order isCoverPicture } floorplans { name resourceId resourcePath size type order isCoverPicture } property { objectId name category subtype type ownershipType fullAddress } unit { id objectId name category type subtype leasingStatusEnum leasingStatusesEnum statusesEnum floorNumber surface livingSurface netFloorSurface hasMainStorage } contractDetails { currency rent totalMonthlyRent parkingRent deposit heatingCostsIncluded utilityCosts heatingCosts petsAllowed displayAmount hasCommission commission commissionNote commissionType } } }**Variables:** You can used any variable in ListingFilter to Copy{ "listingId": "fce90f3a-b8e4-4bc6-b6c0-2539acef5cdc", "propertyId": "e7cde0a1-9708-4fce-b36e-d8b8bcaa695f", "isActive": true, "isArchived": false, "fullSearch": "Hermannstrasse" } Should l be something like this. Copycurl --location --request POST 'https://acme.everreal.co/api/reporting/graphql' \ --header 'authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2ZTdhZmRlOC0xODFjLTQyNzUtYjY1NC1lNmJmZTZiMTZhZWIiLCJzdWIiOiI0MTQ2OWVjMS0yMjkzLTRjMjMtYWVmNy1lZjA4YzBkZTU0ZjEiLCJleHAiOjE2NTU3Mjc2NDEsImlhdCI6MTY1NTcyNDA0MX0.VbA7zl36QrIxRdFVKPluKC0PGrvS_4IFcWUajVQQLfDR6fsXArD8Q83btZ6Fz1UUjloRjFMmfugtIvDIRF1TvQBnDJFyx5568tpDg-H5nSRQ0iQ0fv8mRIGQWdigkXozo2FjHYO1alzU44GVcRx4JxABclexeDjKqeRklr5Gbb-z4fa_jbnMfB4z9mCK0nmy08igMzAB6Zgy0-yHuMpj6aXU-GNL1ti50sDVgNiQRDXUEZN2vor1S9c3sUYA521vBkszvWEXRgM_2ndV8sR8L-Tsma331ojL3PvEm1UNGjVj_yE6RhHIqdwxF7KsqhiUHjFKzgESLSOl3yIUTE10uw' \ --header 'Content-Type: application/json' \ --header 'Cookie: accept-language=en-US' \ --data-raw '{"query":" query listingsQuery(\n $from: Date\n $to: Date\n $companyId: String\n $propertyId: String\n $propertyGroupId: String\n $ownerId: String\n $listingId: String\n $isArchived: Boolean\n $isActive: Boolean\n $fullSearch: String\n ) {\n listings(\n input: {\n paging: { take: 100, skip: 0 }\n filter: {\n from: $from\n to: $to\n companyId: $companyId\n propertyGroupId: $propertyGroupId\n propertyId: $propertyId\n ownerId: $ownerId\n listingId: $listingId\n isArchived: $isArchived\n isActive: $isActive\n fullSearch: $fullSearch\n }\n }\n ) {\n id\n title\n type\n isArchived\n isActive\n companyId\n coverPicture {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n pictures {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n documents {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n floorplans {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n property {\n id\n objectId\n name\n category\n subtype\n type\n ownershipType\n fullAddress\n }\n unit {\n id\n objectId\n name\n category\n type\n subtype\n leasingStatusEnum\n leasingStatusesEnum\n statusesEnum\n floorNumber\n surface\n livingSurface\n netFloorSurface\n hasMainStorage\n }\n contractDetails {\n currency\n rent\n totalMonthlyRent\n parkingRent\n deposit\n heatingCostsIncluded\n utilityCosts\n heatingCosts\n petsAllowed\n displayAmount\n hasCommission\n commission\n commissionNote\n commissionType\n }\n }\n }","variables":{"listingId":"fce90f3a-b8e4-4bc6-b6c0-2539acef5cdc","propertyId":"e7cde0a1-9708-4fce-b36e-d8b8bcaa695f","isActive":true,"isArchived":false,"fullSearch":"Hermannstrasse"}}'Copyvar myHeaders = new Headers(); myHeaders.append("authorization", "Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2ZTdhZmRlOC0xODFjLTQyNzUtYjY1NC1lNmJmZTZiMTZhZWIiLCJzdWIiOiI0MTQ2OWVjMS0yMjkzLTRjMjMtYWVmNy1lZjA4YzBkZTU0ZjEiLCJleHAiOjE2NTU3Mjc2NDEsImlhdCI6MTY1NTcyNDA0MX0.VbA7zl36QrIxRdFVKPluKC0PGrvS_4IFcWUajVQQLfDR6fsXArD8Q83btZ6Fz1UUjloRjFMmfugtIvDIRF1TvQBnDJFyx5568tpDg-H5nSRQ0iQ0fv8mRIGQWdigkXozo2FjHYO1alzU44GVcRx4JxABclexeDjKqeRklr5Gbb-z4fa_jbnMfB4z9mCK0nmy08igMzAB6Zgy0-yHuMpj6aXU-GNL1ti50sDVgNiQRDXUEZN2vor1S9c3sUYA521vBkszvWEXRgM_2ndV8sR8L-Tsma331ojL3PvEm1UNGjVj_yE6RhHIqdwxF7KsqhiUHjFKzgESLSOl3yIUTE10uw"); myHeaders.append("Content-Type", "application/json"); var graphql = JSON.stringify({ query: " query listingsQuery(\n $from: Date\n $to: Date\n $companyId: String\n $propertyId: String\n $propertyGroupId: String\n $ownerId: String\n $listingId: String\n $isArchived: Boolean\n $isActive: Boolean\n $fullSearch: String\n ) {\n listings(\n input: {\n paging: { take: 100, skip: 0 }\n filter: {\n from: $from\n to: $to\n companyId: $companyId\n propertyGroupId: $propertyGroupId\n propertyId: $propertyId\n ownerId: $ownerId\n listingId: $listingId\n isArchived: $isArchived\n isActive: $isActive\n fullSearch: $fullSearch\n }\n }\n ) {\n id\n title\n type\n isArchived\n isActive\n companyId\n coverPicture {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n pictures {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n documents {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n floorplans {\n name\n resourceId\n resourcePath\n size\n type\n order\n isCoverPicture\n }\n property {\n id\n objectId\n name\n category\n subtype\n type\n ownershipType\n fullAddress\n }\n unit {\n id\n objectId\n name\n category\n type\n subtype\n leasingStatusEnum\n leasingStatusesEnum\n statusesEnum\n floorNumber\n surface\n livingSurface\n netFloorSurface\n hasMainStorage\n }\n contractDetails {\n currency\n rent\n totalMonthlyRent\n parkingRent\n deposit\n heatingCostsIncluded\n utilityCosts\n heatingCosts\n petsAllowed\n displayAmount\n hasCommission\n commission\n commissionNote\n commissionType\n }\n }\n }", variables: {"listingId":"fce90f3a-b8e4-4bc6-b6c0-2539acef5cdc","propertyId":"e7cde0a1-9708-4fce-b36e-d8b8bcaa695f","isActive":true,"isArchived":false,"fullSearch":"Hermannstrasse"} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("https://acme.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));### [](https://api-docs.everreal.co/endpoints/listing#mutation)Mutation Mutations are responsible to update a specific operations like activating, deactivating listing or archiving or unarchiving listing. Copytype Mutation { updateListing(listing: ListingInput): Listing }Here are details on the capabilities of different mutations - updateListing: Is used to perform update on an listing with the help of a listing Id, this will help is performing some basic operations listed below ### [](https://api-docs.everreal.co/endpoints/listing#schema-definition)Schema Definition Copyinput ListingInput { id: String! action: LISTING_ACTIONS! } enum LISTING_ACTIONS { ACTIVATE_LISTING DEACTIVATE_LISTING ARCHIVE_LISTING UNARCHIVE_LISTING }Below we are providing a full example how to update listing, all this information is not required, only the ones that was using **!**notation previously. graphQLcURLJavaScriptCopy mutation { updateListing( listing: { id: "42b751a6-3eb6-4e48-a0d1-8e9959151672" action: ACTIVATE_LISTING } ) { id } }Copycurl --location --request POST 'http://.everreal.co/api/reporting/graphql' \ --header 'Authorization: Bearer ....' \ --header 'Content-Type: application/json' \ --header 'Cookie: accept-language=de-DE' \ --data-raw '{"query":"\r\nmutation {\r\n updateListing(\r\n listing: {\r\n id: \"42b751a6-3eb6-4e48-a0d1-8e9959151672\"\r\n action: ACTIVATE_LISTING\r\n }\r\n ) {\r\n id\r\n }\r\n}","variables":{}}'Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Cookie", "accept-language=de-DE"); var graphql = JSON.stringify({ query: "\r\nmutation {\r\n updateListing(\r\n listing: {\r\n id: \"42b751a6-3eb6-4e48-a0d1-8e9959151670\"\r\n action: ACTIVATE_LISTING\r\n }\r\n ) {\r\n id\r\n }\r\n}", variables: {} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("http://.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));[PreviousUnits Mutation](https://api-docs.everreal.co/endpoints/units/units-mutation)[NextListing Query](https://api-docs.everreal.co/endpoints/listing/listing-query)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/listing Crawling: https://api-docs.everreal.co/endpoints/listing/listing-query ============================================================ Title: Listing Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing)- [Listing Query](https://api-docs.everreal.co/endpoints/listing/listing-query) - [Listing Mutation](https://api-docs.everreal.co/endpoints/listing/listing-mutation) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ### [](https://api-docs.everreal.co/endpoints/listing/listing-query#query)Query To understand what is necessary and how to use GraphQl, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)Copytype Query { listings(input: ListingFilterListPaging): [Listing] avgListingActivity(input: AvgActivityFilter): AvgListingActivity listingCounts(input: ListingCountsFilter): ListingCounts } type AvgListingActivity { activeListings: Int } type ListingCounts { listingsMissingViewings: Int listingsMissingContracts: Int activeAndPublished: Int olderThan30Days: Int listingsInContracting: Int listingsContractingCompleted: Int listingsMoveinCompleted: Int } type Listing { id: String title: String type: String isArchived: Boolean isActive: Boolean companyId: String listingResponsible: User contractDetails: ListingContractDetails coverPicture: IFile pictures: [IFile] documents: [IFile] floorplans: [IFile] company: Company status: LISTING_STATUS amenities: ListingAmenities listingInformation: ListingInformation availableFrom: Date propertyId: String property: Property unitId: String unit: Unit descriptions: ListingDescription createdAt: DateTime updatedAt: DateTime } type ListingAmenities { amenitiesIncluded: [AMENITIES_INCLUDED] # See this type under units page parking: UnitParkingType # See this type under units page qualityOfAmenities: String condition: String lastRenovationYear: Int heatingType: String mainEnergySource: String energyPerformanceCertificateAvailability: ENERGY_PERFORMANCE_CERTIFICATE_AVAILABILITY energyCertificateCreationDate: ENERGY_CERTIFICATE_CREATION_DATE buildingEnergyRatingType: BUILDING_ENERGY_RATING_TYPE thermalCharacteristic: Float energyConsumptionContainsWarmWater: Boolean energyEfficiencyClass: ENERGY_EFFICIENCY_CLASS } type ListingDescription { object: String amenities: String location: String other: String } type ListingContractDetails { currency: String rent: Float totalMonthlyRent: Float parkingRent: Float deposit: Float heatingCostsIncluded: Boolean utilityCosts: Float heatingCosts: Float petsAllowed: String displayAmount: Float hasCommission: Boolean commission: String commissionNote: String commissionType: String } enum UNIT_TYPE { APARTMENT HOUSE PARKING OFFICE STORE GASTRONOMY INDUSTRY SPECIAL_PURPOSE LAN } enum LISTING_TYPE { RENT_APARTMENT SELL_APARTMENT RENT_SHORT_TERM_APARTMENT RENT_HOUSE SELL_HOUSE RENT_PARKING SELL_PARKING RENT_RESIDENTIAL_LAND SELL_RESIDENTIAL_LAND RENT_OFFICE SELL_OFFICE RENT_STORE SELL_STORE RENT_GASTRONOMY SELL_GASTRONOMY RENT_INDUSTRY SELL_INDUSTRY RENT_SPECIAL_PURPOSE SELL_SPECIAL_PURPOSE RENT_COMMERCIAL_LAND SELL_COMMERCIAL_LAND } enum LISTING_STATUS { OPEN_FOR_CANDIDATES OPEN_FOR_APPLICANTS CONTRACTING_STARTED CONTRACTING_COMPLETED MOVE_IN_COMPLETED IS_INACTIVE IS_ARCHIVED } enum CANDIDATE_SOURCE { APPLIED_EVERREAL MANUAL_EVERREAL_CANDIDATE MANUAL_EVERREAL_SCHEDULED MANUAL_EVERREAL_APPLICANT IMMOSCOUT24 WG_GESUCHT IMMOWELT IMMONET IVD24 NWZ OPENIMMO_GENERIC EBAY OFFLINE_CONTRACT } input ListingFilter { from: Date to: Date candidateSources: [CANDIDATE_SOURCE] companyId: String propertyGroupId: String propertyId: String ownerId: String listingId: String external: Boolean fullSearch: String isArchived: Boolean isActive: Boolean internalAdvertiseId: String availableFrom: Date externalPropertyId: String scoringTemplateId: String propertyCity: String propertyName: String propertyStreet: String listingType: LISTING_TYPE status: LISTING_STATUS responsibleFullName: String unitName: String unitId: String externalUnitId: String unitType: UNIT_TYPE priceMin: Float priceMax: Float roomsMin: Int roomsMax: Int surfaceMin: Int surfaceMax: Int livingSurfaceMin: Int livingSurfaceMax: Int heightMax: Int heightMin: Int listingResponsibleUserId: String projectId: String candidateEmail: String candidateIsWinner: Boolean } input ListingFilterListPaging { filter: ListingFilter paging: GraphPaging sort: GraphSorting } input ListingCountsFilter { userId: String companyId: String } Usage: GraphQLCopy query listingsQuery( $from: Date $to: Date $companyId: String $propertyId: String $propertyGroupId: String $ownerId: String $listingId: String $isArchived: Boolean $isActive: Boolean $fullSearch: String ) { listings( input: { paging: { take: 100, skip: 0 } filter: { from: $from to: $to companyId: $companyId propertyGroupId: $propertyGroupId propertyId: $propertyId ownerId: $ownerId listingId: $listingId isArchived: $isArchived isActive: $isActive fullSearch: $fullSearch } } ) { id title type isArchived isActive companyId amenities{ amenitiesIncluded qualityOfAmenities } floorplans { name resourceId resourcePath } property { objectId name category fullAddress } unit { id objectId name } contractDetails { currency rent totalMonthlyRent } } }**Variables:** You can used any variable in ListingFilter to Copy{ "listingId": "fce90f3a-b8e4-4bc6-b6c0-2539acef5cdc", "propertyId": "e7cde0a1-9708-4fce-b36e-d8b8bcaa695f", "isActive": true, "isArchived": false, "fullSearch": "Hermannstrasse" }[PreviousListing](https://api-docs.everreal.co/endpoints/listing)[NextListing Mutation](https://api-docs.everreal.co/endpoints/listing/listing-mutation)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/listing/listing-query Crawling: https://api-docs.everreal.co/endpoints/listing/listing-mutation ============================================================ Title: Listing Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing)- [Listing Query](https://api-docs.everreal.co/endpoints/listing/listing-query) - [Listing Mutation](https://api-docs.everreal.co/endpoints/listing/listing-mutation) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Mutations are responsible to update a specific operations like activating, deactivating listing or archiving or unarchiving listing. Copytype Mutation { updateListing(listing: ListingInput): Listing }Here are details on the capabilities of different mutations - updateListing: Is used to perform update on an listing with the help of a listing Id, this will help is performing some basic operations listed below ### [](https://api-docs.everreal.co/endpoints/listing/listing-mutation#schema-definition)Schema Definition Copyinput ListingInput { id: String! action: LISTING_ACTIONS! } enum LISTING_ACTIONS { ACTIVATE_LISTING DEACTIVATE_LISTING ARCHIVE_LISTING UNARCHIVE_LISTING }Below we are providing a full example how to update listing, all this information is not required, only the ones that was using **!**notation previously. graphQLcURLJavaScriptCopy mutation { updateListing( listing: { id: "42b751a6-3eb6-4e48-a0d1-8e9959151672" action: ACTIVATE_LISTING } ) { id } }Copycurl --location --request POST 'http://.everreal.co/api/reporting/graphql' \ --header 'Authorization: Bearer ....' \ --header 'Content-Type: application/json' \ --header 'Cookie: accept-language=de-DE' \ --data-raw '{"query":"\r\nmutation {\r\n updateListing(\r\n listing: {\r\n id: \"42b751a6-3eb6-4e48-a0d1-8e9959151672\"\r\n action: ACTIVATE_LISTING\r\n }\r\n ) {\r\n id\r\n }\r\n}","variables":{}}'Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Cookie", "accept-language=de-DE"); var graphql = JSON.stringify({ query: "\r\nmutation {\r\n updateListing(\r\n listing: {\r\n id: \"42b751a6-3eb6-4e48-a0d1-8e9959151670\"\r\n action: ACTIVATE_LISTING\r\n }\r\n ) {\r\n id\r\n }\r\n}", variables: {} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("http://.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));j[PreviousListing Query](https://api-docs.everreal.co/endpoints/listing/listing-query)[NextCandidates](https://api-docs.everreal.co/endpoints/candidates)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/listing/listing-mutation Crawling: https://api-docs.everreal.co/endpoints/candidates ============================================================ Title: Candidates | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates)- [Candidates Query](https://api-docs.everreal.co/endpoints/candidates/candidates-query) - [Candidate Mutation](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To use EverReal playground is required to provide the Bearer token, read more on the Master Data page A candidate represents a new prospect that is added to a listing. This candidate is unique to a listing, only based on email, if the same person uses 2 emails, they will be seen as 2 candidates and cannot be merged at the moment. When a candidate is added, a contact is also created in the system automatically, based on the email passed. While the same person can exist multiple times over one listing, there can only by one contact with the same email [PreviousListing Mutation](https://api-docs.everreal.co/endpoints/listing/listing-mutation)[NextCandidates Query](https://api-docs.everreal.co/endpoints/candidates/candidates-query)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/candidates Crawling: https://api-docs.everreal.co/endpoints/candidates/candidates-query ============================================================ Title: Candidates Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates)- [Candidates Query](https://api-docs.everreal.co/endpoints/candidates/candidates-query) - [Candidate Mutation](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/candidates/candidates-query#introduction) - [Query](https://api-docs.everreal.co/endpoints/candidates/candidates-query#query) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/candidates/candidates-query#introduction)Introduction A candidate represents a new prospect that is added to a listing. This candidate is unique to a listing, only based on email, if the same person uses 2 emails, they will be seen as 2 candidates and cannot be merged at the moment. To understand what is necessary and how to use GraphQL, on master data page we explain what is necessary to do ### [](https://api-docs.everreal.co/endpoints/candidates/candidates-query#query)Query Queries are responsible to pull data from GraphQL. For more information please read the GraphQL documentation. Copytype Query { candidates(input: CandidatesFilterListPaging): [Candidate] } type Candidate { id: String email: String firstName: String lastName: String fullName: String companyContactId: String listingId: String rating: Float notes: String candidateSource: String isNewCandidate: Boolean isNewApplicant: Boolean isSharedApplicant: Boolean isToDo: Boolean isInvited: Boolean isScheduled: Boolean isApplicant: Boolean isDisabled: Boolean isPendingCandidate: Boolean isFromInvestment: Boolean hasSharedDataRoom: Boolean longExposeNoViews: Int longExposeLastView: DateTime hadAcceptedSellingCancelationNotice: Boolean sellingCancellationStatus: CandidateSellingCancellationStatusType viewingStartDate: DateTime disabledReason: CandidateDisabledReason scheduledStatus: CANDIDATE_SCHEDULED_STATUS scoring: CandidateScoreType statuses: CandidateStatuses notificationStatuses: CandidateNotificationStatuses createdAt: DateTime updatedAt: DateTime applications: [ListingCandidateApplication] listing: Listing } enum CANDIDATE_SCHEDULED_STATUS { NOT_INVITED INVITED ADMIN_CANCELLED CANDIDATE_CANCELLED SCHEDULED NEW_TIMESLOTS_REQUESTED } type ListingCandidateApplication { id: String candidateId: String email: String userId: String isMainCandidate: Boolean applicationDataString: String applicationData: ApplicationData } type ApplicationData { isFinancingReady: Boolean isAnyoneSmoking: Boolean hasPets: Boolean hasEligibilityCertificate: Boolean email: String firstName: String lastName: String eligibilityExpirationDate: String employmentType: String householdPersons: Int } type CandidateSellingCancellationStatusType { date: DateTime checkedSellingCancellation: Boolean checkedExplicitelyStartEarly: Boolean checkedAcceptFee: Boolean acceptedFeeDate: DateTime } type CandidateScoreType { totalScore: Float } type CandidateDisabledReason { reason: String message: String } type CandidateStatuses { scheduledStatus: String vettingStatus: String disabledStatus: String } type CandidateNotificationStatuses { hasReceivedStep2InviteEmail: DateTime hasReceivedStep2InvitationFromAdmin: DateTime hasReceivedGdprNotification: DateTime hasReceived24hrsBeforeViewingReminder: DateTime hasReceivedAfterViewingInviteReminder: DateTime hasReceived24hrAfterViewingStep2Reminder: DateTime hadReceivedSellingCancelationNotice: DateTime } input CandidatesFilter { id: String companyId: String ownerId: String propertyGroupId: String propertyId: String candidateSources: [String] disabledReasons: [String] isApplicant: Boolean isDisabled: Boolean from: Date to: Date external: Boolean updatedAt: IDateRange } input CandidatesFilterListPaging { filter: CandidatesFilter paging: GraphPaging sort: GraphSorting }GraphQLCopyquery candidates( $companyId: String $propertyId: String $isApplicant: Boolean ) { candidates( input: { paging: { take: 100, skip: 0 } filter: { companyId: $companyId propertyId: $propertyId isApplicant: $isApplicant } } ) { id email firstName lastName fullName rating candidateSource isApplicant isDisabled isPendingCandidate isFromInvestment hasSharedDataRoom hadAcceptedSellingCancelationNotice viewingStartDate disabledReason { reason message } statuses { scheduledStatus vettingStatus disabledStatus } notificationStatuses { hasReceivedStep2InviteEmail hasReceivedStep2InvitationFromAdmin hasReceivedGdprNotification hasReceived24hrsBeforeViewingReminder hasReceivedAfterViewingInviteReminder hasReceived24hrAfterViewingStep2Reminder hadReceivedSellingCancelationNotice } applications { id candidateId email userId isMainCandidate applicationDataString } } } [PreviousCandidates](https://api-docs.everreal.co/endpoints/candidates)[NextCandidate Mutation](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/candidates/candidates-query Crawling: https://api-docs.everreal.co/endpoints/candidates/candidate-mutation ============================================================ Title: Candidate Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates)- [Candidates Query](https://api-docs.everreal.co/endpoints/candidates/candidates-query) - [Candidate Mutation](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation#introduction) - [Mutation types](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation#mutation-types) Was this helpful? Please keep in mind **GDPR**. Before you add a new candidate in EverReal, please make sure that he accepted your company terms and conditions. ### [](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation#introduction)Introduction A candidate represents a new prospect that is added to a listing. After a candidate was added a few things are happening in EverReal: - One of 3 emails is sent to the candidate. There is no way to turn off emails as of now. - Request to submit more information, if necessary - Request to choose a time slot, if the listing is configure to auto-invite candidates and times slots are available - A thank you email, if none of the above - Please note that if the email address is invalid, EverReal will blacklist it for 3 months. - A contact is also created in the system, that is unique based on the email address - A message is attached to the candidate record, based on the message field - If the candidate is added multiple times, his information is updated - A webhook request is also sent, if you are using the candidate API webhook. To create a new candidate you are required to have at least 4 **required** parameters: - the listingId you are adding the candidate to - email - firstName - lastName Other **optional** parameters to the candidate mutation are: Copymessage: String phoneNumber: String desiredStartDate: Date noTotalPeopleMovingIn: Int netMonthlyIncomeRanges: IncomeRangeInput currency: CURRENCY_TYPE employmentType: CANDIDATE_EMPLOYMENT_TYPE### [](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation#mutation-types)Mutation types Mutations are responsible to update or perform changes in GraphQL. For more information please read the GraphQL documentation. Copytype Mutation { upsertCandidateInitialApplication( listingId: String candidate: CandidateInitialApplicationRequest ): CandidateInitialApplicationResponse } input CandidateInitialApplicationRequest { firstName: String! lastName: String! email: String! message: String phoneNumber: String desiredStartDate: Date noTotalPeopleMovingIn: Int netMonthlyIncomeRanges: IncomeRangeInput currency: CURRENCY_TYPE employmentType: CANDIDATE_EMPLOYMENT_TYPE isFinancingReady: Boolean isAnyoneSmoking: Boolean hasPets: Boolean hasEligibilityCertificate: Boolean } type CandidateInitialApplicationResponse { success: Boolean } input IncomeRangeInput { from: Int! to: Int! } enum CURRENCY_TYPE { EUR USD GBP CHF DKK HRK HUF NOK SEK BGN CZK PLN RON AED } enum CANDIDATE_EMPLOYMENT_TYPE { EMPLOYED SELF_EMPLOYED STUDENT SEEKING_WORK CLERK RETIRED HOUSE_MAN_WIFE APPRENTICE POSTGRADUATE OTHER } Below we are providing a full example how to create or update a candidate using this mutation: Copy# Write your query or mutation here mutation { upsertCandidateInitialApplication( listingId:"1eb2ad05-e692-4439-9ee9-2f61f3ff64bb", candidate:{ email:"liviu+candidateintegration3@ignat.email" firstName:"Liviu" lastName:"from integrations", message: "Hi, how are u mate", currency: EUR, phoneNumber: "+49123456", desiredStartDate: "2022-12-01", noTotalPeopleMovingIn: 3, netMonthlyIncomeRanges: {from: 3000, to: 4000}, employmentType: CLERK } ){ success } } [PreviousCandidates Query](https://api-docs.everreal.co/endpoints/candidates/candidates-query)[NextMessages](https://api-docs.everreal.co/endpoints/messages)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/candidates/candidate-mutation Crawling: https://api-docs.everreal.co/endpoints/messages ============================================================ Title: Messages | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? GraphQL interface for messages. Copyenum MESSAGE_SENT_BY { ADMIN CANDIDATE } type MessageAttachment { id: String name: String resourcePath: String type: String size: Int } type Message { id: String candidateId: String sentBy: MESSAGE_SENT_BY userId: String text: String user: User replyToMessageId: String isRead: Boolean attachments: [MessageAttachment] } input MessageFilterPaging { filter: MessageFilter paging: GraphPaging sort: GraphSorting } input MessageFilter { candidateId: String contactId: String listingId: String } type Query { messages(input: MessageFilterPaging): [Message] } Usage of Query: GraphQLCURLJavascriptCopyquery message($candidateId: String, $contactId: String, $listingId: String) { messages( input: { filter: { candidateId: $candidateId contactId: $contactId listingId: $listingId } } ) { id candidateId sentBy text isRead attachments { id name resourcePath type size } } }**Variables:** Using either of these 3 should give an error if no variables not given. Copy{ "candidateId": "a50ddf78-c792-4461-b77e-c36ec444ddb5", "contactId": "6aec3680-a1de-4e5b-b3d9-67cb4b4727f6", "listingId": "1840826c-08aa-419c-9779-c0a0dfcbd190" } Copycurl --location --request POST 'https://acme-qa.everreal-dev.co/api/reporting/graphql' \ --header 'Authorization: Bearer ....' \ --header 'Content-Type: application/json' \ --data-raw '{"query":"query message($candidateId: String, $contactId: String, $externalContactId: String, $listingId: String) {\n messages(\n input: {\n filter: {\n candidateId: $candidateId\n contactId: $contactId\n externalContactId: $externalContactId\n listingId: $listingId\n }\n }\n ) {\n id\n candidateId\n sentBy\n text\n isRead\n attachments {\n id\n name\n resourcePath\n type\n size\n }\n }\n }","variables":{"candidateId":"a50ddf78-c792-4461-b77e-c36ec444ddb5","contactId":"6aec3680-a1de-4e5b-b3d9-67cb4b4727f6","listingId":"1840826c-08aa-419c-9779-c0a0dfcbd190"}}'Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); var graphql = JSON.stringify({ query: "query message($candidateId: String, $contactId: String, $externalContactId: String, $listingId: String) {\n messages(\n input: {\n filter: {\n candidateId: $candidateId\n contactId: $contactId\n externalContactId: $externalContactId\n listingId: $listingId\n }\n }\n ) {\n id\n candidateId\n sentBy\n text\n isRead\n attachments {\n id\n name\n resourcePath\n type\n size\n }\n }\n }", variables: {"candidateId":"a50ddf78-c792-4461-b77e-c36ec444ddb5","contactId":"6aec3680-a1de-4e5b-b3d9-67cb4b4727f6","listingId":"1840826c-08aa-419c-9779-c0a0dfcbd190"} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("https://acme-qa.everreal-dev.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error)); [PreviousCandidate Mutation](https://api-docs.everreal.co/endpoints/candidates/candidate-mutation)[NextContact Activites](https://api-docs.everreal.co/endpoints/contact-activites)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/messages Crawling: https://api-docs.everreal.co/endpoints/contact-activites ============================================================ Title: Contact Activites | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? GraphQL interface for messages. Copytype Query { contactActivity(input: ActivityFilterPaging): [Activity] } enum COMPANY_CONTACT_ACTIVITY_CATEGORY { EMAIL NOTE CALL SMS SEARCH_PROFILE_UPDATE DATA_ROOM_VIEWED USER_BLACKLISTED USER_UNBLACKLISTED } type Activity { id: String companyId: String listingId: String candidateId: String companyContactId: String messageId: String tenantId: String searchProfileId: String createdByUserId: String category: COMPANY_CONTACT_ACTIVITY_CATEGORY type: String text: String } input ActivityFilterPaging { filter: ActivityFilter paging: GraphPaging sort: GraphSorting } input ActivityFilter { contactId: String companyId: String } Usage of Query: GraphQLCURLJavascriptCopyquery contactActivity($companyId: String, $contactId: String) { contactActivity( input: { filter: { companyId: $companyId, contactId: $contactId } } ) { id companyId listingId candidateId messageId type text category } } **Variables:** Using either of these two, should give an error if no variables are not given. Copy{ "contactId": "6aec3680-a1de-4e5b-b3d9-67cb4b4727f6", "companyId": "341de250-2fd6-11e7-9e51-ff0020488d44" }Copycurl --location --request POST 'https://acme-qa.everreal-dev.co/api/reporting/graphql' \ --header 'Authorization: Bearer ...' \ --header 'Content-Type: application/json' \ --data-raw '{"query":"query contactActivity($companyId: String, $contactId: String, $externalContactId: String) {\n contactActivity(\n input: { filter: { companyId: $companyId, contactId: $contactId, externalContactId: $externalContactId } }\n ) {\n id\n companyId\n listingId\n candidateId\n messageId\n type\n text\n category\n }\n }","variables":{"contactId":"6aec3680-a1de-4e5b-b3d9-67cb4b4727f6","companyId":"341de250-2fd6-11e7-9e51-ff0020488d44"}}'Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); var graphql = JSON.stringify({ query: "query contactActivity($companyId: String, $contactId: String, $externalContactId: String) {\n contactActivity(\n input: { filter: { companyId: $companyId, contactId: $contactId, externalContactId: $externalContactId } }\n ) {\n id\n companyId\n listingId\n candidateId\n messageId\n type\n text\n category\n }\n }", variables: {"contactId":"6aec3680-a1de-4e5b-b3d9-67cb4b4727f6","companyId":"341de250-2fd6-11e7-9e51-ff0020488d44"} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("https://acme-qa.everreal-dev.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error)); [PreviousMessages](https://api-docs.everreal.co/endpoints/messages)[NextTenants](https://api-docs.everreal.co/endpoints/tenants)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/contact-activites Crawling: https://api-docs.everreal.co/endpoints/tenants ============================================================ Title: Tenants | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants)- [Tenants Query](https://api-docs.everreal.co/endpoints/tenants/tenants-query) - [Tenant Mutation](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [GraphQL Endpoint](https://api-docs.everreal.co/endpoints/tenants#graphql-endpoint) - [GraphQL endpoint to perform tenant operations](https://api-docs.everreal.co/endpoints/tenants#graphql-endpoint-to-perform-tenant-operations) Was this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use GraphQL, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)### [](https://api-docs.everreal.co/endpoints/tenants#graphql-endpoint)GraphQL Endpoint ## [](https://api-docs.everreal.co/endpoints/tenants#graphql-endpoint-to-perform-tenant-operations)GraphQL endpoint to perform tenant operations POST http://{custom_subdomain}.everreal.co/api/reporting/graphql Body of the request should follow GraphQL mutation structure like mutation { mutationName(input: {MutationNameInput!}) { MutationNamePayload } } [PreviousContact Activites](https://api-docs.everreal.co/endpoints/contact-activites)[NextTenants Query](https://api-docs.everreal.co/endpoints/tenants/tenants-query)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/tenants Crawling: https://api-docs.everreal.co/endpoints/tenants/tenants-query ============================================================ Title: Tenants Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants)- [Tenants Query](https://api-docs.everreal.co/endpoints/tenants/tenants-query) - [Tenant Mutation](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/tenants/tenants-query#introduction) - [Tenant Query](https://api-docs.everreal.co/endpoints/tenants/tenants-query#tenant-query) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/tenants/tenants-query#introduction)**Introduction** Our tenant query will get you the list of tenants from the respective company. We provides ability to filter the tenant query by externalId, updatedAt and candidateSources. Please make sure the paging option is used to fetch more items. ### [](https://api-docs.everreal.co/endpoints/tenants/tenants-query#tenant-query)Tenant Query To query a property group from Everreal use tenants query Copytype Query { tenants(input: TenantFilterListPaging): [Tenant] }**Schema** Copyinput TenantFilterListPaging { filter: TenantFilter paging: GraphPaging sort: GraphSorting } input TenantFilter { id: String candidateSources: [String] externalId: String updatedAt: IDateRange } input IDateRange { from: String to: String } input GraphPaging { skip: Int take: Int } input GraphSorting { fieldName: String direction: String } type Tenant { id: String externalId: String email: String firstName: String lastName: String company: Company createdAt: DateTime updatedAt: DateTime companyContact: CompanyContact } type CompanyContact { userId: String externalId: String firstName: String lastName: String email: String phoneNumber: String cellPhoneNumber: String } type Company { id: String name: String partnerId: String listings: [Listing] }_example for tenant query_ GraphQLCopy{ tenants( input: { filter: { externalId: "external-tenant-3" } paging: { skip: 0, take: 20 } } ) { id firstName lastName externalId email company { id } createdAt updatedAt } } [PreviousTenants](https://api-docs.everreal.co/endpoints/tenants)[NextTenant Mutation](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/tenants/tenants-query Crawling: https://api-docs.everreal.co/endpoints/tenants/tenant-mutation ============================================================ Title: Tenant Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants)- [Tenants Query](https://api-docs.everreal.co/endpoints/tenants/tenants-query) - [Tenant Mutation](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Mutation Types](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation#mutation-types) - [Schema Definition](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation#schema-definition) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation#mutation-types)Mutation Types Mutations are responsible to insert or update a specific register, the operation insert or update is defined by **externalId**, in case this tenant was imported previously, this mutation will updated the resource, otherwise will create the tenant. If you wish to update the externalId, pass EverReal UUID as id in the mutation payload along with the changed externalId Copytype Mutation { upsertTenant(tenant: TenantInput): Tenant deleteTenant(externalId: String): AsyncEventResponse removeTenant(id: String): Boolean }Here are details on the capabilities of different mutations - The upsertTenant mutation is used to create or update a tenant in Everreal system and tenant added to the system cannot be modified by Everreal and if needs to be modified it should be done via the same endpoint itself. - The deleteTenant mutation is used to delete the tenant relation with the external integration source, doing this will not delete the tenant but instead it will remain as a detached tenant from integration and can be modified using Everreal. - The removeTenant mutation is used to remove the tenant from the system, in order to perform removeTenant, please make sure that all the contracts assosiated with the tenant is been removed ( [reference](https://api-docs.everreal.co/endpoints/contract/contract-mutation) to delete contract) ### [](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation#schema-definition)Schema Definition items with **!**notation are required Copyinput TenantInput { id:String #EverReal UUID typically can be passes in case of updating externalId externalTenantId: String! #externalTenantId by which the tenent is identified unitId: String! #unitId by which the tenent will be attached to. You have to either pass unitId or exteranalunitId externalUnitId: String! #exteranalunitId by which the tenent will be attached to. You have to either pass unitId or exteranalunitId firstName: String! lastName: String! email: String companyName: String phoneNumber: String cellPhoneNumber: String additionalTenants: [AdditionalTenant] coldRent: String # number format should be numeric "123456.34" serviceCharges: String # number format should be numeric "123456.34" heatingCosts: String # number format should be numeric "123456.34" totalRent: String # number format should be numeric "123456.34" securityDeposit: String # number format should be numeric "123456.34" contractStartDate: String #date format should be "YYYY-MM-DD" or "DD.MM.YYYY" contractEndDate: String #date format should be "YYYY-MM-DD" or "DD.MM.YYYY" terminationDate: String #date format should be "YYYY-MM-DD" or "DD.MM.YYYY" meta: MetaInformation! customFieldValues: [CustomFieldValueInput] } input AdditionalTenant { externalId: String firstName: String lastName: String email: String phoneNumber: String } input MetaInformation { source: String! } input CustomFieldValueInput { key: String! value: JSON } type AsyncEventResponse { statusCode: Int message: String } Below we are providing a full example how to create or update a tenant, all this information is not required, only the ones that was using **!**notation previously. graphQLJavaScriptCopymutation { upsertTenant( tenant: { meta: { source: "INTEGRATION_SOURCE" } externalTenantId: "91001+006" externalUnitId: "11092+1101" firstName: "Ivana" lastName: "Maric" email: "ivanamaric@everreal.co" coldRent: "900.00" serviceCharges: "880.00" heatingCosts: "3.00" totalRent: "500" securityDeposit: "500" contractStartDate: "01.01.2020" contractEndDate: "01.01.2024" companyName: "gmbh" } ) { id } }Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ...."); myHeaders.append("Content-Type", "application/json"); var graphql = JSON.stringify({ query: '\r\n mutation {\r\n upsertTenant(\r\n tenant: {\r\n meta: { source: "INTEGRATION_SOURCE" }\r\n externalTenantId: "91001+0069330"\r\n externalUnitId: "11092+1101122211s"\r\n firstName: "Ivana"\r\n lastName: "Maric"\r\n email: "ivana@masssric.de"\r\n coldRent: "900.00"\r\n serviceCharges: "880.00"\r\n heatingCosts: "3.00"\r\n totalRent: "500"\r\n securityDeposit: "500"\r\n contractStartDate: "01.01.2020"\r\n contractEndDate: "01.01.2024"\r\n placeOfBirth: "thotta"\r\n companyName: "Everreal Gmbh"\r\n }\r\n ) {\r\n id\r\n }\r\n}', variables: {}, }); var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("http://{subdomain}.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error)); [PreviousTenants Query](https://api-docs.everreal.co/endpoints/tenants/tenants-query)[NextContract](https://api-docs.everreal.co/endpoints/contract)Last updated 29 days ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/tenants/tenant-mutation Crawling: https://api-docs.everreal.co/endpoints/contract ============================================================ Title: Contract | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract)- [Contract Query](https://api-docs.everreal.co/endpoints/contract/contract-query) - [Contract Mutation](https://api-docs.everreal.co/endpoints/contract/contract-mutation) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use graphql, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)[PreviousTenant Mutation](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation)[NextContract Query](https://api-docs.everreal.co/endpoints/contract/contract-query)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/contract Crawling: https://api-docs.everreal.co/endpoints/contract/contract-query ============================================================ Title: Contract Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract)- [Contract Query](https://api-docs.everreal.co/endpoints/contract/contract-query) - [Contract Mutation](https://api-docs.everreal.co/endpoints/contract/contract-mutation) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use graphql, in Master Data page we explain what is necessary to do [Ideal CSV Structure](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/master-data)Copytype Query { contracts(input: ContractsFilterListPaging): [Contract] } type ContractTerms { rent: Float deposit: Float heatingCosts: Float utilityCosts: Float totalMonthlyRent: Float contractEndDate: Date contractStartDate: Date } type ContractData { terms: ContractTerms } type Contract { id: String startDate: Date endDate: Date contractFlowType: CONTRACT_FLOW_TYPE status: String candidate: Candidate units: [Unit] tenants: [Tenant] tenantFullNames: String versions: [JSON] contractData: ContractData contractDataString: String createdAt: DateTime updatedAt: DateTime } input ListContractFilter { id: String companyId: String propertyGroupId: String propertyId: String status: String from: Date to: Date } input ContractsFilterListPaging { filter: ListContractFilter paging: GraphPaging sort: GraphSorting } enum CONTRACT_FLOW_TYPE { VIRTUAL OFFLINE DOWNLOAD_UPLOAD ELECTRONIC_SIGNATURE_V2 ELECTRONIC_SIGNATURE_QES }GraphQLCURLJavascriptCopy query contracts($companyId: String, $propertyId: String, $status: String) { contracts( input: { paging: { take: 100, skip: 0 } filter: { companyId: $companyId, propertyId: $propertyId, status: $status } } ) { id contractDataString startDate endDate status unit { id } candidate { id } versions contractData { terms { rent deposit heatingCosts utilityCosts totalMonthlyRent } } contractDataString createdAt } }Copycurl --location --request POST 'https://acme.everreal.co/api/reporting/graphql' \ --header 'Authorization: Bearer ....' \ --header 'Content-Type: application/json' \ --header 'Cookie: accept-language=en-US' \ --data-raw '{"query":" query contracts($companyId: String, $propertyId: String, $status: String) {\n contracts(\n input: {\n paging: { take: 100, skip: 0 }\n filter: { companyId: $companyId, propertyId: $propertyId, status: $status }\n }\n ) {\n id\n contractDataString\n startDate\n endDate\n status\n unit {\n id\n }\n candidate {\n id\n }\n versions\n contractData {\n terms {\n rent\n deposit\n heatingCosts\n utilityCosts\n totalMonthlyRent\n }\n }\n contractDataString\n createdAt\n }\n }","variables":{"status":"CONTRACT_TERMINATED"}}'Copyvar myHeaders = new Headers(); myHeaders.append("Authorization", "Bearer ..."); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Cookie", "accept-language=en-US"); var graphql = JSON.stringify({ query: " query contracts($companyId: String, $propertyId: String, $status: String) {\n contracts(\n input: {\n paging: { take: 100, skip: 0 }\n filter: { companyId: $companyId, propertyId: $propertyId, status: $status }\n }\n ) {\n id\n contractDataString\n startDate\n endDate\n status\n unit {\n id\n }\n candidate {\n id\n }\n versions\n contractData {\n terms {\n rent\n deposit\n heatingCosts\n utilityCosts\n totalMonthlyRent\n }\n }\n contractDataString\n createdAt\n }\n }", variables: {"status":"CONTRACT_TERMINATED"} }) var requestOptions = { method: 'POST', headers: myHeaders, body: graphql, redirect: 'follow' }; fetch("https://acme.everreal.co/api/reporting/graphql", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));// Some code[PreviousContract](https://api-docs.everreal.co/endpoints/contract)[NextContract Mutation](https://api-docs.everreal.co/endpoints/contract/contract-mutation)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/contract/contract-query Crawling: https://api-docs.everreal.co/endpoints/contract/contract-mutation ============================================================ Title: Contract Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract)- [Contract Query](https://api-docs.everreal.co/endpoints/contract/contract-query) - [Contract Mutation](https://api-docs.everreal.co/endpoints/contract/contract-mutation) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ### [](https://api-docs.everreal.co/endpoints/contract/contract-mutation#mutation-types)Mutation Types Mutations are responsible to insert or update a specific register, the operation insert or update is defined by **everreal****Id**, in case this contract you could use to delete contract. Copytype Mutation { removeContract(id: String): AsyncEventResponse } type AsyncEventResponse { statusCode: Int message: String }Here are details on the capabilities of different mutations - The removeContract mutation is used to delete a contract from Everreal system and contract will no longer be available in Everreal. To delete contract, you should pass everrealUUID which can be acquired from contracting query by passing the propertyId for which you need to delete the contract.([reference](https://api-docs.everreal.co/endpoints/contract/contract-query) to get contractId) Below we are providing a full example how to delete GraphQLSecond TabCopymutation { removeContract( id: ) } [PreviousContract Query](https://api-docs.everreal.co/endpoints/contract/contract-query)[NextContacts](https://api-docs.everreal.co/endpoints/contacts)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/contract/contract-mutation Crawling: https://api-docs.everreal.co/endpoints/contacts ============================================================ Title: Contacts | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts)- [Contact Mutation](https://api-docs.everreal.co/endpoints/contacts/contact-mutation) - [Contact Query](https://api-docs.everreal.co/endpoints/contacts/contact-query) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To use EverReal playground is required to provide the Bearer token, read more in Master Data page To understand what is necessary and how to use graphql, in Master Data page we explain what is necessary to do [PreviousContract Mutation](https://api-docs.everreal.co/endpoints/contract/contract-mutation)[NextContact Mutation](https://api-docs.everreal.co/endpoints/contacts/contact-mutation)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/contacts Crawling: https://api-docs.everreal.co/endpoints/contacts/contact-mutation ============================================================ Title: Contact Mutation | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts)- [Contact Mutation](https://api-docs.everreal.co/endpoints/contacts/contact-mutation) - [Contact Query](https://api-docs.everreal.co/endpoints/contacts/contact-query) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ### [](https://api-docs.everreal.co/endpoints/contacts/contact-mutation#mutation-types)**Mutation Types** Mutations are responsible to insert or update a specific register, the operation insert or update is defined by **everreal****Id**, in case this contact you could use to delete contact. Copytype Mutation { removeContact(id: String): AsyncEventResponse } type AsyncEventResponse { statusCode: Int message: String }Here are details on the capabilities of different mutations - The removeContact mutation is used to delete a contact from Everreal system and contact will no longer be available in Everreal. To delete contact, you should pass everrealUUID which can be acquired from tenants endpoint.([reference](https://api-docs.everreal.co/endpoints/tenants/tenant-mutation) to delete tenant) Below we are providing a full example how to delete GraphQLCopymutation { removeContact( id: ) }[PreviousContacts](https://api-docs.everreal.co/endpoints/contacts)[NextContact Query](https://api-docs.everreal.co/endpoints/contacts/contact-query)Last updated 6 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/contacts/contact-mutation Crawling: https://api-docs.everreal.co/endpoints/contacts/contact-query ============================================================ Title: Contact Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts)- [Contact Mutation](https://api-docs.everreal.co/endpoints/contacts/contact-mutation) - [Contact Query](https://api-docs.everreal.co/endpoints/contacts/contact-query) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/contacts/contact-query#introduction) - [Contact Query](https://api-docs.everreal.co/endpoints/contacts/contact-query#contact-query) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/contacts/contact-query#introduction)**Introduction** Contacts are the company contact that a company user can add in our system. We provides ability to filter the contacts by externalId, email, id and fullSearch(first name and last name). Please make sure the paging option is used to fetch more items. ### [](https://api-docs.everreal.co/endpoints/contacts/contact-query#contact-query)Contact Query To query a contacts from Everreal use contacts query Copytype Query { contacts(input: ContactFilterListPaging): [Contact] }**Schema** Copytype Contact { id: String externalId: String salutation: String title: String firstName: String lastName: String email: String userId: String companyId: String phoneNumber: String address: ContactAddress cellPhoneNumber: String birthDate: DateTime blacklistReason: String companyContactGroupId: String gdprAcceptedDate: String gdprAcceptedIpAddress: String isBlacklisted: String responsibleUserId: String createdAt: DateTime updatedAt: DateTime deletedAt: DateTime } type ContactAddress { streetName: String streetNumber: String zipCode: String city: String country: String } input ContactFilterListPaging { filter: ContactFilter paging: GraphPaging sort: GraphSorting } input ContactFilter { id: String externalId: String email: String fullSearch: String }_**Example for contact query**_ GraphQLCopy{ contacts(input: { filter: { email: "test@acme.com"}, paging: {skip: 0, take: 5}}) { id firstName lastName salutation title email createdAt updatedAt } }[PreviousContact Mutation](https://api-docs.everreal.co/endpoints/contacts/contact-mutation)[NextDocument management](https://api-docs.everreal.co/endpoints/document-management)Last updated 9 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/contacts/contact-query Crawling: https://api-docs.everreal.co/endpoints/document-management ============================================================ Title: Document management | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management)- [Document management](https://api-docs.everreal.co/endpoints/document-management/document-management) - [Simple file upload](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ## [](https://api-docs.everreal.co/endpoints/document-management#introduction)Introduction #### [](https://api-docs.everreal.co/endpoints/document-management#everreal-provides-2-ways-to-upload-files)EverReal provides 2 ways to upload files. 1. Uploading a **document** that can be linked to various entities directly. 2. Uploading a **file** for later use that can be transformed to a document later or can be used for other data sources, like linking it to a listing. #### [](https://api-docs.everreal.co/endpoints/document-management#most-common-scenarios)Most common scenarios - For uploading documents to properties and units, please use the [Document management](https://api-docs.everreal.co/endpoints/document-management/document-management) page. - For uploading files for listings please use the [Simple file upload](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload) page. #### [](https://api-docs.everreal.co/endpoints/document-management#important-to-know)Important to know - All files uploaded to your account are tracked and are subject to extra cost if the account file size exceeds 10GB - Maximum file size allowed to be uploaded is 20MB - We don't support uploading in chunks for bigger file sizes - yet - Images are resized automatically for storage optimisation to a maximum size /or width of 2500px. - A relative path needs to be passed for every upload as resourcePath property and we will return the final resourcePath with the company namespace appended to it, similar to something like: subdomain/{accountUniqueIdentifier}/{resourcePath}. - for documents we also append the document id at the end, so the final resourcePath will look like subdomain/{accountUniqueIdentifier}/{resourcePath}/{documentId} - To get the complete URL to the file, you should append one of these urls: - https://resources.everreal.co/returnedResourcePath for production environment - https://qa.resources.everreal.co/returnedResourcePath for staging environment - We don't provide an "update" endpoint, because the CDN will cache the resources, thus we recommend always creating a new file and to delete the old one. The CDN cache is between 1h to 24h. #### [](https://api-docs.everreal.co/endpoints/document-management#gdpr)GDPR - All files are stored in AWS S3 and encrypted on bucket level and only we, as EverReal have access to it. [PreviousContact Query](https://api-docs.everreal.co/endpoints/contacts/contact-query)[NextDocument management](https://api-docs.everreal.co/endpoints/document-management/document-management)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/document-management Crawling: https://api-docs.everreal.co/endpoints/document-management/document-management ============================================================ Title: Document management | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management)- [Document management](https://api-docs.everreal.co/endpoints/document-management/document-management) - [Simple file upload](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/document-management/document-management#introduction) - [Endpoints](https://api-docs.everreal.co/endpoints/document-management/document-management#endpoints) - [Upload a document with metadata](https://api-docs.everreal.co/endpoints/document-management/document-management#upload-a-document-with-metadata-1) - [Deletes a document by id](https://api-docs.everreal.co/endpoints/document-management/document-management#deletes-a-document-by-id) - [Get all documents metadata from a company and filter](https://api-docs.everreal.co/endpoints/document-management/document-management#get-all-documents-metadata-from-a-company-and-filter) - [Get a single document metadata](https://api-docs.everreal.co/endpoints/document-management/document-management#get-a-single-document-metadata) Was this helpful? ## [](https://api-docs.everreal.co/endpoints/document-management/document-management#introduction)Introduction Important notes - Documents represents files that are uploaded and have metadata that link them to different objects in EverReal. Documents can be linked to tenants, units, properties, property groups. If you want to upload files and link them to listings later, please read the [Simple file upload](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload) section. - Documents need to have a resourcePath that is a "virtual folder" in EverReal. Recommended resource paths - Tenant documents: tenants/$tenantId - Property documents: properties/$propertyId - Unit documents: units/$unitId - property group documents: properties/$propertyId - documents attached to a property group should also be attached to a property as well ## [](https://api-docs.everreal.co/endpoints/document-management/document-management#endpoints)Endpoints #### [](https://api-docs.everreal.co/endpoints/document-management/document-management#upload-a-document-with-metadata)Upload a document with metadata Uploading a document is a multipart/form-data operation that can pass via multipart parameters several required or optional parameters. Please note that the field metadata needs to be passed as string JSON and can contain the following data: Copy// The type of document type?: DOCUMENT_TYPES; // Link a document to a tenant by id tenantId?: string; // Link the document to a unit by id unitId?: string; // Link the document to a property by id propertyId?: string; // Link the document to a property group by id propertyGroupId?: string; enum DOCUMENT_TYPES { // default document type DOCUMENT = "DOCUMENT", // rental application of a tenant, passed during rental process RENTAL_APPLICATION = "RENTAL_APPLICATION", // contract with a tenant or buyer CONTRACT = "CONTRACT", // move-in protocol MOVE_IN = "MOVE_IN", // move-out protocol MOVE_OUT = "MOVE_OUT", // pre-move-in protocol PRE-MOVE_IN = "PRE-MOVE_IN", // selling protocol SELLING = "SELLING", }Sample response Copy{ "id": "f2d8b7a5-9e58-4347-8864-35243fd952b0", "resourcePath": "subdomain/116aeae1-615a-11e7-97db-257f422c1234/properties/117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4/f2d8b7a5-9e58-4347-8864-35243fd952b0", "title": "Floor plans", "companyId": "116aeae1-615a-11e7-97db-257f422c1234", "type": "DOCUMENT", "propertyId": "117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4", "propertyGroupId": null, "unitId": null, "tenantId": null, "candidateId": "3512f79f-5c99-49ce-a517-df838cce75b7", "email": null, "mediaType": "image/png", "size": 10473459, "createdAt": "2023-05-24T09:43:19.043Z", "updatedAt": "2023-05-24T09:43:19.043Z" } // afterwards the file will be accessible at // https://resources.everreal.co/subdomain/116aeae1-615a-11e7-97db-257f422c1234/properties/117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4/f2d8b7a5-9e58-4347-8864-35243fd952b0## [](https://api-docs.everreal.co/endpoints/document-management/document-management#upload-a-document-with-metadata-1)Upload a document with metadata POST https://{custom_subdomain}.everreal.co/api/file-storage/company/documents The parameters are passed via form data and are listed below. #### [](https://api-docs.everreal.co/endpoints/document-management/document-management#request-body)Request Body NameTypeDescriptionfile* form Data File File buffer resourcePath* String Example: /protocols/:id metadata* String String metadata as json string, example {\"propertyId\": \"{propertyId}\", \"unitId\": \"{unitId}\"} name String Force another file name format ENUM JPEG,PNG . Will force the conversion to JPEG or PNG of any image. 201: Created Create id is in "Location" header401: Unauthorized 400: Bad Request cURLTypescriptJavaC#The example below will upload a file and attach it to a property and unit by passing metadata as string JSON. Copy curl --location "${BASE_URL}/api/file-storage/company/documents" \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {accessToken}' \ --form 'file=@"file blob multipart"' \ --form 'resourcePath="units/{unitId}"' \ --form 'name="Floor plans"' \ --form 'metadata="{\"propertyId\": \"{propertyId}\", \"unitId\": \"{unitId}\"}"'The example below will upload a file and attach it to a property and unit by passing metadata as string JSON. Copyconst uploadFile = (input: { fileInput: Buffer; accessToken: string; propertyId: string; unitId: string }) => { const { fileInput, accessToken, propertyId, unitId } = input; const myHeaders = new Headers(); myHeaders.append('Accept', 'application/json'); myHeaders.append('Authorization', `Bearer ${accessToken}`); const formdata = new FormData(); formdata.append('file', fileInput, { filename: 'Sample-png-image-10mb.png', contentType: 'image/png' }); formdata.append('resourcePath', `units/${unitId}`); formdata.append('name', 'Move-in protocol John Doe, Unit 1'); formdata.append('metadata', JSON.stringify({ propertyId, unitId, type: 'MOVE_IN' })); const requestOptions = { method: 'POST', headers: myHeaders, body: formdata, redirect: 'follow', }; fetch(`{baseUrl}/api/file-storage/company/documents`, requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.log('error', error)); };The example below will upload a file and attach it to a property and unit by passing metadata as string JSON. CopyOkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM) .addFormDataPart("file","Sample-png-image-10mb.png", RequestBody.create(MediaType.parse("application/octet-stream"), new File("/pathtofile/Sample-png-image-10mb.png"))) .addFormDataPart("resourcePath","properties/117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4") .addFormDataPart("name","Floor plans") .addFormDataPart("metadata","{\"propertyId\": \"117ff3a1-6f1b-4da8-a3da-208d2e6f5123\",\"unitId\": \"117ff3a1-6f1b-4da8-a3da-208d2e6f5567\"}") .build(); Request request = new Request.Builder() .url("{baseUrk}/api/file-storage/company/documents") .method("POST", body) .addHeader("Accept", "application/json") .addHeader("Authorization", "Bearer {accessToken}") .build(); Response response = client.newCall(request).execute();The example below will upload a file and attach it to a property and unit by passing metadata as string JSON. Copyvar client = new HttpClient(); var request = new HttpRequestMessage(HttpMethod.Post, baseUrl + "/api/file-storage/company/documents"); request.Headers.Add("Accept", "application/json"); request.Headers.Add("Authorization", "Bearer " + accessToken); var content = new MultipartFormDataContent(); content.Add(new StreamContent(File.OpenRead("/pathtofile/Sample-png-image-10mb.png")), "file", "/pathtofile/Sample-png-image-10mb.png"); content.Add(new StringContent("properties/117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4"), "resourcePath"); content.Add(new StringContent("Floor plans"), "name"); content.Add(new StringContent("{\"propertyId\": \"117ff3a1-6f1b-4da8-a3da-208d2e6f123\", \"unitId\": \"117ff3a1-6f1b-4da8-a3da-208d2e6f5567\"}"), "metadata"); request.Content = content; var response = await client.SendAsync(request); response.EnsureSuccessStatusCode(); Console.WriteLine(await response.Content.ReadAsStringAsync()); #### [](https://api-docs.everreal.co/endpoints/document-management/document-management#delete-a-document-by-id)Delete a document by id ## [](https://api-docs.everreal.co/endpoints/document-management/document-management#deletes-a-document-by-id)Deletes a document by id DELETE https://{custom_subdomain}.everreal.co/api/file-storage/company/documents/{documentId} #### [](https://api-docs.everreal.co/endpoints/document-management/document-management#path-parameters)Path Parameters NameTypeDescriptiondocumentId String 401: Unauthorized 404: Not Found 204: No Content #### [](https://api-docs.everreal.co/endpoints/document-management/document-management#get-all-documents-metadata-and-or-apply-filters)Get all documents metadata and / or apply filters ## [](https://api-docs.everreal.co/endpoints/document-management/document-management#get-all-documents-metadata-from-a-company-and-filter)Get all documents metadata from a company and filter GET https://{custom_subdomain}.everreal.co/api/file-storage/company/documents/metadata Can get all documents metadata from an account and filter by certain parameters passed via query string. The response can be used to display a list of documents or to query via resourcePath and download the files. #### [](https://api-docs.everreal.co/endpoints/document-management/document-management#query-parameters)Query Parameters NameTypeDescriptionunitId String propertyId String propertyGroupId String candidateId String tenantId String types Array String See documentation above for available values skip Number How many items should skip take Number Ho many items should take. propertyGroupId String title String tenantId String 200: OK 401: Unauthorized Copy[{ "id": "f2d8b7a5-9e58-4347-8864-35243fd952b0", "resourcePath": "subdomain/116aeae1-615a-11e7-97db-257f422c1234/properties/117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4/f2d8b7a5-9e58-4347-8864-35243fd952b0", "title": "Floor plans", "companyId": "116aeae1-615a-11e7-97db-257f422c1234", "type": "DOCUMENT", "propertyId": "117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4", "propertyGroupId": null, "unitId": null, "tenantId": null, "candidateId": "3512f79f-5c99-49ce-a517-df838cce75b7", "email": null, "mediaType": "image/png", "size": 10473459, "createdAt": "2023-05-24T09:43:19.043Z", "updatedAt": "2023-05-24T09:43:19.043Z" }] #### [](https://api-docs.everreal.co/endpoints/document-management/document-management#get-document-metadata-by-id)Get document metadata by id ## [](https://api-docs.everreal.co/endpoints/document-management/document-management#get-a-single-document-metadata)Get a single document metadata GET https://{custom_subdomain}.everreal.co/api/file-storage/company/documents/{documentId}/metadata 200: OK 401: Unauthorized 404: Not Found [PreviousDocument management](https://api-docs.everreal.co/endpoints/document-management)[NextSimple file upload](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload)Last updated 6 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/document-management/document-management Crawling: https://api-docs.everreal.co/endpoints/document-management/simple-file-upload ============================================================ Title: Simple file upload | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management)- [Document management](https://api-docs.everreal.co/endpoints/document-management/document-management) - [Simple file upload](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Introduction](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#introduction) - [Endpoints](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#endpoints) Was this helpful? ## [](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#introduction)Introduction Please use this endpoint only if you don't want to automatically link the files to properties, units, tenants. For example this endpoint could be used for: - creating a listing via API (currently only possible with restricted access and not yet documented) - updating a user profile image via API - submit candidate / applicant information, with files via API (currently only possible with restricted access and not yet documented) ## [](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#endpoints)Endpoints #### [](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#upload-a-file)Upload a file GET https://{custom_subdomain}.everreal.co/api/file-storage/company/files #### [](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#request-body)Request Body NameTypeDescriptionfile* Form file The file resourcePath* String The virtual folder path name String Override the display name of the file 200: OK 401: Unauthorized #### [](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#delete-a-file)Delete a file DELETE https://{custom_subdomain}.everreal.co/api/file-storagecompany/files?resourcePath={uploadedResourcePath} 204: No Content 401: Unauthorized #### [](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload#example-flow-for-creating-a-listing)Example flow for creating a listing - upload image1.jpeg , image2.jpeg , floorPlan.pdf - pass the responses to the create listing payload Step 1 - upload images Copy// Do this for every image const myHeaders = new Headers(); myHeaders.append('Accept', 'application/json'); myHeaders.append( 'Authorization', 'Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwZTY1Y2ViYi1lNDI4LTQ4YTktOTY4MS03NmRkYTM0ZDIyOTkiLCJzdWIiOiJkNWY4ZmI5My1kYTIxLTQwNTktYjhjOC0wN2M0MjE0OTczMTkiLCJleHAiOjE2ODUwMTAyMjEsImlhdCI6MTY4NTAwNjYyMX0.byF0tReLQOYRXwvgssQG1HFfrxWOPm1WdA4ZcLyJMX6LDxg586pjebiyBtE7cJvFAHhDxIdXGlp6LLDs-HaGmk10H-HMmRdLG4gHzs-QRz4goQIVgUv3kikG5YseXMgqmRCssXtBVbo-XjS_bHFSLkMV5zNESByliYLFJReXXpQTC_LP3PUdA7qvnL4PZAwbcoa6aPKyPtuur9gCXvcVDgvFdzQQ5WMnr9u0CiXMeqk3ybAMUTD9RdXYBpTDoJChemFDq0E1-GYDBbC-WuwOsw5sYPokCjuD-7ARsm6UaBxNExJWYUz5erpVhewNZHiGhOyUqARomV8QcbatiL-RNw', ); const formdata = new FormData(); formdata.append('file', fileInput, { filename: 'Living Room', contentType: 'image/png' }); formdata.append('resourcePath', 'listings/117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4/pictures'); formdata.append('name', 'Floor plans'); const requestOptions = { method: 'POST', headers: myHeaders, body: formdata, redirect: 'follow', }; fetch('https://{subdomain}.everreal.co/api/file-storage/company/files', requestOptions) .then((response) => response.json()) .then((result) => console.log(result)) .catch((error) => console.log('error', error));Response will be something like Copy{ "name": "Floor plans", "resourcePath": "subdomain/116aeae1-615a-11e7-97db-257f422c12345/listings/117ff3a1-6f1b-4da8-a3da-208d2e6f5ac4/pictures", "size": 389417, "type": "image/png" }Step 2 - pass payload during create listing Copyconst body = { /// other data pictures: [{ ...responsePicture1, order: 0, }, { ...responsePicture2, order: 1, }], floorPlans: [{ ...responseFloorPlanPdf, order: 0 }] }; const requestOptions = { method: 'POST', headers: {....}, body }; fetch('https://{subdomain}.everreal.co/api/create-listing-endpoint', requestOptions) .then((response) => response.json()) .then((result) => console.log(result)) .catch((error) => console.log('error', error));[PreviousDocument management](https://api-docs.everreal.co/endpoints/document-management/document-management)[NextTasks](https://api-docs.everreal.co/endpoints/tasks)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/document-management/simple-file-upload Crawling: https://api-docs.everreal.co/endpoints/tasks ============================================================ Title: Tasks | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks)- [Tasks Query](https://api-docs.everreal.co/endpoints/tasks/tasks-query) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? To use EverReal playground is required to provide the Bearer token, read more on the Master Data page [PreviousSimple file upload](https://api-docs.everreal.co/endpoints/document-management/simple-file-upload)[NextTasks Query](https://api-docs.everreal.co/endpoints/tasks/tasks-query)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/tasks Crawling: https://api-docs.everreal.co/endpoints/tasks/tasks-query ============================================================ Title: Tasks Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks)- [Tasks Query](https://api-docs.everreal.co/endpoints/tasks/tasks-query) - [Protocols](https://api-docs.everreal.co/endpoints/protocols) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Queries are responsible to pull data from GraphQL. For more information please read the GraphQL documentation. Below you can view a sample of the task query. The query accepts an input that can filter the list. The list returns the tasks ordered by createdAt descending. ### [](https://api-docs.everreal.co/endpoints/tasks/tasks-query#filter-options)Filter options - assigneeEmail - filter by assignee email - reporterEmail - filter by reporter email - status - filter by task status. See possible options in types below. - type - filter by task type. See possible options in types below. - taskId - pass an id of a task to return a single task - companyId - pass a companyId to filter by. Only usable if a customer has multiple subsidiaries. GraphQLCopyquery tasks( $assigneeEmail: String $reporterEmail: String $status: TASK_STATUSES $type: TASK_TYPES $taskId: String $companyId: String ) { tasks( input: { paging: { take: 20, skip: 0 } filter: { assigneeEmail: $assigneeEmail reporterEmail: $reporterEmail status: $status type: $type taskId: $taskId companyId: $companyId } } ) { id title description status createdAt links { label listingId contactId unitId propertyId } assignee { id email firstName lastName } reporter { id email firstName lastName } comments { id comment createdAt user { id email firstName lastName } } } } #### [](https://api-docs.everreal.co/endpoints/tasks/tasks-query#sample-types)Sample types Copy enum TASK_TYPES { GENERIC EXPOSE_REVIEW APPLICANT_REVIEW } enum TASK_STATUSES { TODO IN_PROGRESS DONE } type Task { id: String title: String description: String type: String status: String numberOfComments: Int dueDate: DateTime lastSeenAt: DateTime archivedAt: DateTime createdAt: DateTime updatedAt: DateTime comments: [TaskComment] assignee: User reporter: User } type TaskComment { id: String user: User comment: String createdAt: DateTime } [PreviousTasks](https://api-docs.everreal.co/endpoints/tasks)[NextProtocols](https://api-docs.everreal.co/endpoints/protocols)Last updated 1 year ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/tasks/tasks-query Crawling: https://api-docs.everreal.co/endpoints/protocols ============================================================ Title: Protocols | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols)- [Protocol Query](https://api-docs.everreal.co/endpoints/protocols/protocol-query) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [Protocol Query](https://api-docs.everreal.co/endpoints/protocols/protocol-query)[PreviousTasks Query](https://api-docs.everreal.co/endpoints/tasks/tasks-query)[NextProtocol Query](https://api-docs.everreal.co/endpoints/protocols/protocol-query)Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/protocols Crawling: https://api-docs.everreal.co/endpoints/protocols/protocol-query ============================================================ Title: Protocol Query | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints)- [Account users / members](https://api-docs.everreal.co/endpoints/account-users-members) - [Owners](https://api-docs.everreal.co/endpoints/owners) - [Property Groups](https://api-docs.everreal.co/endpoints/property-groups) - [Properties](https://api-docs.everreal.co/endpoints/properties) - [Units](https://api-docs.everreal.co/endpoints/units) - [Listing](https://api-docs.everreal.co/endpoints/listing) - [Candidates](https://api-docs.everreal.co/endpoints/candidates) - [Messages](https://api-docs.everreal.co/endpoints/messages) - [Contact Activites](https://api-docs.everreal.co/endpoints/contact-activites) - [Tenants](https://api-docs.everreal.co/endpoints/tenants) - [Contract](https://api-docs.everreal.co/endpoints/contract) - [Contacts](https://api-docs.everreal.co/endpoints/contacts) - [Document management](https://api-docs.everreal.co/endpoints/document-management) - [Tasks](https://api-docs.everreal.co/endpoints/tasks) - [Protocols](https://api-docs.everreal.co/endpoints/protocols)- [Protocol Query](https://api-docs.everreal.co/endpoints/protocols/protocol-query) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [Protocol query](https://api-docs.everreal.co/endpoints/protocols/protocol-query#protocol-query) - [Filter options](https://api-docs.everreal.co/endpoints/protocols/protocol-query#filter-options) - [Protocol Query](https://api-docs.everreal.co/endpoints/protocols/protocol-query#protocol-query-1) - [Schema](https://api-docs.everreal.co/endpoints/protocols/protocol-query#schema) - [Example](https://api-docs.everreal.co/endpoints/protocols/protocol-query#example) Was this helpful? ### [](https://api-docs.everreal.co/endpoints/protocols/protocol-query#protocol-query)Protocol query The protocol graphQL query allows one to retrieve protocols information from EverReal. ### [](https://api-docs.everreal.co/endpoints/protocols/protocol-query#filter-options)Filter options - id - filter by the protocol id - draftId - filter by the protocol draft id - companyId - filter by company id - unitId - filter by the unit id - propertyId - filter by the property id - protocolType - filter by the protocol type. See possible options in types below. ### [](https://api-docs.everreal.co/endpoints/protocols/protocol-query#protocol-query-1)Protocol Query To query a protocol from EverReal use protocol query Copytype Query { protocols(input: ProtocolFilterListPaging): [Protocol] }### [](https://api-docs.everreal.co/endpoints/protocols/protocol-query#schema)Schema Copyenum ProtocolType { MOVE_IN MOVE_OUT SELLING PRE_MOVE_OUT } enum ProtocolVersion { V1 V2 } type Protocol { id: ID! protocolVersion: ProtocolVersion companyId: String! propertyId: String unitId: String documentId: String additionalNotes: String moveInExtraInformation: MoveInExtraInformation moveOutExtraInformation: MoveOutExtraInformation sellingExtraInformation: SellingExtraInformation uploadsRootId: String draftId: String protocolType: ProtocolType! createdAt: DateTime! updatedAt: DateTime! deletedAt: DateTime property: Property unit: Unit company: Company rooms: [ProtocolRoom!]! meters: [ProtocolMeter!]! keysets: [ProtocolKeyset!]! persons: [ProtocolPerson!]! savingProgress: ProtocolSavingProgress signatureAcknowledgementText: String } type ProtocolRoom { id: ID! protocolId: String! name: String! floorType: ProtocolRoomFloorType wallType: ProtocolRoomWallType ceilingType: ProtocolRoomCeilingType smokeDetectors: Int additionalNotes: String hasPreinstalledFurniture: ProtocolRoomFurniture roomInGoodCondition: Boolean isInspected: Boolean createdAt: DateTime! updatedAt: DateTime! } type ProtocolMeter { id: ID! protocolId: String! unitMeterId: String stand: String type: ProtocolMeterType! number: String! pictures: [File!] createdAt: DateTime! updatedAt: DateTime! deletedAt: DateTime } type ProtocolKeyset { id: ID! protocolId: String! unitKeysetId: String quantity: Int! type: ProtocolKeysetType model: String pictures: [File!] keyNumbers: [ProtocolKeyNumber!] createdAt: DateTime! updatedAt: DateTime! deletedAt: DateTime } type ProtocolPerson { id: ID! protocolId: String! companyContactId: String email: String firstName: String lastName: String phoneNumber: String role: ProtocolPersonType signature: ProtocolPersonSignature createdAt: DateTime! updatedAt: DateTime! } type ProtocolFilterListPaging { filter: ProtocolFilter paging: GraphPaging sort: GraphSorting } type ProtocolFilter { id: String draftId: String companyId: String propertyId: String unitId: String protocolType: ProtocolType } type GraphPaging { skip: Int take: Int } type GraphSorting { fieldName: String direction: String } ### [](https://api-docs.everreal.co/endpoints/protocols/protocol-query#example)Example GraphQLJavaScriptCopyquery GetProtocols { protocols(input: { filter:{ id:"b953017a-3824-4b44-a28f-e872a3c53b09" unitId:"b953017a-3824-4b44-a28f-e872a3c53b08", propertyId:"b953017a-3823-4b44-a28f-e872a3c53b09", draftId:"b953017a-3824-4b44-a28f-e872a4c53b09", companyId:"341de250-2fd6-11e7-9e51-ff0020488d44", protocolType:"V2" } } ){ id draftId propertyId companyId unitId protocolType protocolVersion unit { id } company { id } property { id } keysets { id pictures { id } } meters { id protocolId unitMeterId stand number pictures{id} } rooms { id } } }Copyasync function fetchProtocols() { const graphqlEndpoint = 'https://acme-qa.everreal.co/api/reporting/graphql'; // Replace with your actual GraphQL endpoint URL const query = ` query GetProtocols($filterInput: ProtocolFilter!) { protocols(input: { filter: $filterInput }) { id draftId propertyId companyId unitId protocolType protocolVersion unit { id } company { id } property { id } keysets { id pictures { id } } meters { id protocolId unitMeterId stand number pictures { id } } rooms { id } } } `; const variables = { filterInput: { id: "b953017a-3824-4b44-a28f-e872a3c53b09", unitId: "b953017a-3824-4b44-a28f-e872a3c53b08", propertyId: "b953017a-3823-4b44-a28f-e872a3c53b09", draftId: "b953017a-3824-4b44-a28f-e872a4c53b09", companyId: "341de250-2fd6-11e7-9e51-ff0020488d44", protocolType: "V2" } }; try { const response = await fetch(graphqlEndpoint, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Accept': 'application/json', // Add any necessary Authorization headers here e.g., // 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' }, body: JSON.stringify({ query: query, variables: variables // Send variables separately }) }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const result = await response.json(); if (result.errors) { console.error("GraphQL Errors:", result.errors); // Handle GraphQL errors (e.g., validation errors, execution errors) } else { console.log("Protocols Data:", result.data.protocols); // Process the received data (result.data.protocols) return result.data.protocols; } } catch (error) { console.error("Error fetching protocols:", error); // Handle network errors or other exceptions } } // Example usage: fetchProtocols().then(protocols => { if (protocols) { console.log("Successfully fetched protocols."); // Do something with the protocols array } });[PreviousProtocols](https://api-docs.everreal.co/endpoints/protocols)[NextWebhooks](https://api-docs.everreal.co/webhooks)Last updated 5 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/endpoints/protocols/protocol-query Crawling: https://api-docs.everreal.co/webhooks ============================================================ Title: Webhooks | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this page- [List Webhooks](https://api-docs.everreal.co/webhooks#list-webhooks) - [Register a new Webhook](https://api-docs.everreal.co/webhooks#register-a-new-webhook) - [Delete a Webhook](https://api-docs.everreal.co/webhooks#delete-a-webhook) - [Event Types](https://api-docs.everreal.co/webhooks#event-types) - [](https://api-docs.everreal.co/webhooks#undefined-4) Was this helpful? ## [](https://api-docs.everreal.co/webhooks#list-webhooks)List Webhooks GET https://{subdomain}.everreal.co/api/external-integrations/webhooks Endpoint responsible for list all webhooks url registered in EverReal. #### [](https://api-docs.everreal.co/webhooks#headers)Headers NameTypeDescriptionAuthorization string Bearer Token 200 403 User not authorizedCopy[ { "id": "01dd383b-9106-4921-bb53-aasdfa3", "type": "LISTING_CREATED", "partnerId": "01dd383b-9106-4921-bb53-aasdfa3", "companyId": "01dd383b-9106-4921-bb53-aasdfa3", "connectedByUserId": "01dd383b-9106-4921-bb53-aasdfa3", "url": "https://collect2.com/api/01dd383b-9106-4921-bb53-aasdfa3/datarecord/", "createdAt": "2020-09-30T10:07:28.052Z", "updatedAt": "2020-09-30T10:07:28.052Z", "deletedAt": null } ]Copy{ "code": "server_error", "statusCode": 403 }## [](https://api-docs.everreal.co/webhooks#register-a-new-webhook)Register a new Webhook POST https://{subdomain}.everreal.co/api/external-integrations/webhooks Webhook in EverReal server. #### [](https://api-docs.everreal.co/webhooks#headers-1)Headers NameTypeDescriptionAuthorization string Bearer Token #### [](https://api-docs.everreal.co/webhooks#request-body)Request Body NameTypeDescriptionBody Request object { "type":"string", "url":"string" } 200 Copy// Response Header { "Location": "d32d5912-4496-4398-814e-a734ccadb615" }## [](https://api-docs.everreal.co/webhooks#delete-a-webhook)Delete a Webhook DELETE https://{subdomain}.everreal.co/api/external-integrations/webhooks/:id Deletes a webhook by its unique ID. #### [](https://api-docs.everreal.co/webhooks#path-parameters)Path Parameters NameTypeDescription:id string Webhook id provided by EverReal #### [](https://api-docs.everreal.co/webhooks#headers-2)Headers NameTypeDescriptionAuthorization string Bearer Token 204 ## [](https://api-docs.everreal.co/webhooks#event-types)Event Types Below is a list of all events available in EverReal. Each event type has its own data structure used when notifying the external system - on webhooks sub pages we provide details for each event type and data type. EventsList of available actions**Listing events** LISTING_CREATED | LISTING_UPDATED | LISTING_ARCHIVED | LISTING_ACTIVATED | LISTING_DEACTIVATED | LISTING_PUBLISHED_TO_CHANNEL | LISTING_UNPUBLISHED_FROM_CHANNEL **Candidates events** CANDIDATE_PARSED | LISTING_CANDIDATE_APPLIED **Scheduling events** LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING | LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED | LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN | LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE | LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN | LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE **Contracting events** LISTING_CONTRACT_FLOW_STARTED | LISTING_CONTRACT_FLOW_WITHDRAWN | LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED | LISTING_CONTRACT_FLOW_SIGNED **Owner events** OWNER_CREATED | OWNER_UPDATED | OWNER_DELETED **Properties events** PROPERTY_CREATED | PROPERTY_UPDATED | PROPERTY_DELETED **Units events** UNIT_CREATED |UNIT_UPDATED |UNIT_DELETED Below we are providing a full example how to create webhook cURLCopycurl --location --request POST 'https://acme-qa.everreal.co/api/external-integrations/webhooks' \ --header 'Authorization: Bearer eyJhbGciOiJ...' \ --header 'Content-Type: application/json' \ --data-raw '{ "type":"LISTING_CANDIDATE_APPLIED", "url":"https:///" }'## [](https://api-docs.everreal.co/webhooks#undefined-4) [PreviousProtocol Query](https://api-docs.everreal.co/endpoints/protocols/protocol-query)[NextOwner Events](https://api-docs.everreal.co/webhooks/owner-events)Last updated 4 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks Crawling: https://api-docs.everreal.co/webhooks/owner-events ============================================================ Title: Owner Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events)- [OWNER_CREATED](https://api-docs.everreal.co/webhooks/owner-events/owner_created) - [OWNER_UPDATED](https://api-docs.everreal.co/webhooks/owner-events/owner_updated) - [OWNER_DELETED](https://api-docs.everreal.co/webhooks/owner-events/owner_deleted) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [OWNER_CREATED](https://api-docs.everreal.co/webhooks/owner-events/owner_created)[OWNER_UPDATED](https://api-docs.everreal.co/webhooks/owner-events/owner_updated)[OWNER_DELETED](https://api-docs.everreal.co/webhooks/owner-events/owner_deleted)[PreviousWebhooks](https://api-docs.everreal.co/webhooks)[NextOWNER_CREATED](https://api-docs.everreal.co/webhooks/owner-events/owner_created)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/owner-events Crawling: https://api-docs.everreal.co/webhooks/owner-events/owner_created ============================================================ Title: OWNER_CREATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events)- [OWNER_CREATED](https://api-docs.everreal.co/webhooks/owner-events/owner_created) - [OWNER_UPDATED](https://api-docs.everreal.co/webhooks/owner-events/owner_updated) - [OWNER_DELETED](https://api-docs.everreal.co/webhooks/owner-events/owner_deleted) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IOwnerAction { ownerId: string; id: string; firstName: string; lastName: string; email: string; externalId: string; } [PreviousOwner Events](https://api-docs.everreal.co/webhooks/owner-events)[NextOWNER_UPDATED](https://api-docs.everreal.co/webhooks/owner-events/owner_updated)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/owner-events/owner_created Crawling: https://api-docs.everreal.co/webhooks/owner-events/owner_updated ============================================================ Title: OWNER_UPDATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events)- [OWNER_CREATED](https://api-docs.everreal.co/webhooks/owner-events/owner_created) - [OWNER_UPDATED](https://api-docs.everreal.co/webhooks/owner-events/owner_updated) - [OWNER_DELETED](https://api-docs.everreal.co/webhooks/owner-events/owner_deleted) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IOwnerAction { ownerId: string; id: string; firstName: string; lastName: string; email: string; externalId: string; } [PreviousOWNER_CREATED](https://api-docs.everreal.co/webhooks/owner-events/owner_created)[NextOWNER_DELETED](https://api-docs.everreal.co/webhooks/owner-events/owner_deleted)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/owner-events/owner_updated Crawling: https://api-docs.everreal.co/webhooks/owner-events/owner_deleted ============================================================ Title: OWNER_DELETED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events)- [OWNER_CREATED](https://api-docs.everreal.co/webhooks/owner-events/owner_created) - [OWNER_UPDATED](https://api-docs.everreal.co/webhooks/owner-events/owner_updated) - [OWNER_DELETED](https://api-docs.everreal.co/webhooks/owner-events/owner_deleted) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IOwnerAction { ownerId: string; id: string; firstName: string; lastName: string; email: string; externalId: string; } [PreviousOWNER_UPDATED](https://api-docs.everreal.co/webhooks/owner-events/owner_updated)[NextProperty Events](https://api-docs.everreal.co/webhooks/property-events)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/owner-events/owner_deleted Crawling: https://api-docs.everreal.co/webhooks/property-events ============================================================ Title: Property Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events)- [PROPERTY_CREATED](https://api-docs.everreal.co/webhooks/property-events/property_created) - [PROPERTY_UPDATED](https://api-docs.everreal.co/webhooks/property-events/property_updated) - [PROPERTY_DELETED](https://api-docs.everreal.co/webhooks/property-events/property_deleted) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [PROPERTY_CREATED](https://api-docs.everreal.co/webhooks/property-events/property_created)[PROPERTY_UPDATED](https://api-docs.everreal.co/webhooks/property-events/property_updated)[PROPERTY_DELETED](https://api-docs.everreal.co/webhooks/property-events/property_deleted)[PreviousOWNER_DELETED](https://api-docs.everreal.co/webhooks/owner-events/owner_deleted)[NextPROPERTY_CREATED](https://api-docs.everreal.co/webhooks/property-events/property_created)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/property-events Crawling: https://api-docs.everreal.co/webhooks/property-events/property_created ============================================================ Title: PROPERTY_CREATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events)- [PROPERTY_CREATED](https://api-docs.everreal.co/webhooks/property-events/property_created) - [PROPERTY_UPDATED](https://api-docs.everreal.co/webhooks/property-events/property_updated) - [PROPERTY_DELETED](https://api-docs.everreal.co/webhooks/property-events/property_deleted) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IPropertyAction { propertyId: string; name: string; objectId: string; } [PreviousProperty Events](https://api-docs.everreal.co/webhooks/property-events)[NextPROPERTY_UPDATED](https://api-docs.everreal.co/webhooks/property-events/property_updated)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/property-events/property_created Crawling: https://api-docs.everreal.co/webhooks/property-events/property_updated ============================================================ Title: PROPERTY_UPDATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events)- [PROPERTY_CREATED](https://api-docs.everreal.co/webhooks/property-events/property_created) - [PROPERTY_UPDATED](https://api-docs.everreal.co/webhooks/property-events/property_updated) - [PROPERTY_DELETED](https://api-docs.everreal.co/webhooks/property-events/property_deleted) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IPropertyAction { propertyId: string; name: string; objectId: string; } [PreviousPROPERTY_CREATED](https://api-docs.everreal.co/webhooks/property-events/property_created)[NextPROPERTY_DELETED](https://api-docs.everreal.co/webhooks/property-events/property_deleted)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/property-events/property_updated Crawling: https://api-docs.everreal.co/webhooks/property-events/property_deleted ============================================================ Title: PROPERTY_DELETED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events)- [PROPERTY_CREATED](https://api-docs.everreal.co/webhooks/property-events/property_created) - [PROPERTY_UPDATED](https://api-docs.everreal.co/webhooks/property-events/property_updated) - [PROPERTY_DELETED](https://api-docs.everreal.co/webhooks/property-events/property_deleted) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IPropertyAction { propertyId: string; name: string; objectId: string; } [PreviousPROPERTY_UPDATED](https://api-docs.everreal.co/webhooks/property-events/property_updated)[NextUnit Events](https://api-docs.everreal.co/webhooks/unit-events)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/property-events/property_deleted Crawling: https://api-docs.everreal.co/webhooks/unit-events ============================================================ Title: Unit Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events)- [UNIT_CREATED](https://api-docs.everreal.co/webhooks/unit-events/unit_created) - [UNIT_UPDATED](https://api-docs.everreal.co/webhooks/unit-events/unit_updated) - [UNIT_DELETED](https://api-docs.everreal.co/webhooks/unit-events/unit_deleted) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [UNIT_CREATED](https://api-docs.everreal.co/webhooks/unit-events/unit_created)[UNIT_UPDATED](https://api-docs.everreal.co/webhooks/unit-events/unit_updated)[UNIT_DELETED](https://api-docs.everreal.co/webhooks/unit-events/unit_deleted)[PreviousPROPERTY_DELETED](https://api-docs.everreal.co/webhooks/property-events/property_deleted)[NextUNIT_CREATED](https://api-docs.everreal.co/webhooks/unit-events/unit_created)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/unit-events Crawling: https://api-docs.everreal.co/webhooks/unit-events/unit_created ============================================================ Title: UNIT_CREATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events)- [UNIT_CREATED](https://api-docs.everreal.co/webhooks/unit-events/unit_created) - [UNIT_UPDATED](https://api-docs.everreal.co/webhooks/unit-events/unit_updated) - [UNIT_DELETED](https://api-docs.everreal.co/webhooks/unit-events/unit_deleted) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IUnitAction { unitId: string; propertyId: string; name: string; objectId: string; } [PreviousUnit Events](https://api-docs.everreal.co/webhooks/unit-events)[NextUNIT_UPDATED](https://api-docs.everreal.co/webhooks/unit-events/unit_updated)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/unit-events/unit_created Crawling: https://api-docs.everreal.co/webhooks/unit-events/unit_updated ============================================================ Title: UNIT_UPDATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events)- [UNIT_CREATED](https://api-docs.everreal.co/webhooks/unit-events/unit_created) - [UNIT_UPDATED](https://api-docs.everreal.co/webhooks/unit-events/unit_updated) - [UNIT_DELETED](https://api-docs.everreal.co/webhooks/unit-events/unit_deleted) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IUnitAction { unitId: string; propertyId: string; name: string; objectId: string; } [PreviousUNIT_CREATED](https://api-docs.everreal.co/webhooks/unit-events/unit_created)[NextUNIT_DELETED](https://api-docs.everreal.co/webhooks/unit-events/unit_deleted)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/unit-events/unit_updated Crawling: https://api-docs.everreal.co/webhooks/unit-events/unit_deleted ============================================================ Title: UNIT_DELETED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events)- [UNIT_CREATED](https://api-docs.everreal.co/webhooks/unit-events/unit_created) - [UNIT_UPDATED](https://api-docs.everreal.co/webhooks/unit-events/unit_updated) - [UNIT_DELETED](https://api-docs.everreal.co/webhooks/unit-events/unit_deleted) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IUnitAction { unitId: string; propertyId: string; name: string; objectId: string; } [PreviousUNIT_UPDATED](https://api-docs.everreal.co/webhooks/unit-events/unit_updated)[NextListing Events](https://api-docs.everreal.co/webhooks/listing-events)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/unit-events/unit_deleted Crawling: https://api-docs.everreal.co/webhooks/listing-events ============================================================ Title: Listing Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated)[LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived)[LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated)[LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated)[LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created)[LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel)[LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel)[PreviousUNIT_DELETED](https://api-docs.everreal.co/webhooks/unit-events/unit_deleted)[NextLISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events Crawling: https://api-docs.everreal.co/webhooks/listing-events/listing_activated ============================================================ Title: LISTING_ACTIVATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingActivatedAction; } interface IListingActivatedAction{ id: string; title: string; companyId: string; type: LISTING_TYPE; listingResponsible: { id: string; email: string; }; }[PreviousListing Events](https://api-docs.everreal.co/webhooks/listing-events)[NextLISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events/listing_activated Crawling: https://api-docs.everreal.co/webhooks/listing-events/listing_archived ============================================================ Title: LISTING_ARCHIVED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingArchivedAction; } interface IListingArchivedAction { id: string; title: string; companyId: string; type: LISTING_TYPE; listingResponsible: { id: string; email: string; }; } [PreviousLISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated)[NextLISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events/listing_archived Crawling: https://api-docs.everreal.co/webhooks/listing-events/listing_updated ============================================================ Title: LISTING_UPDATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? TypeScriptCopy interface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingCreatedAction; } interface IListingCreatedAction { id: string; title: string; companyId: string; type: LISTING_TYPE; listingResponsible: { id: string; email: string; }; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; contractDetails?: { currency?: CURRENCY_TYPE; rent?: number; totalMonthlyRent?: number; parkingRent?: number; deposit?: number; heatingCostsIncluded?: boolean; utilityCosts?: number; heatingCosts?: number; petsAllowed?: string; displayAmount?: number; hasCommission?: boolean; commission?: number; commissionNote?: string; }; }[PreviousLISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived)[NextLISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events/listing_updated Crawling: https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated ============================================================ Title: LISTING_DEACTIVATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingDeactivatedAction; } interface IListingDeactivatedAction { id: string; title: string; companyId: string; type: LISTING_TYPE; listingResponsible: { id: string; email: string; }; }[PreviousLISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated)[NextLISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated Crawling: https://api-docs.everreal.co/webhooks/listing-events/listing_created ============================================================ Title: LISTING_CREATED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? TypeScriptCopy interface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingCreatedAction; } interface IListingCreatedAction { id: string; title: string; companyId: string; type: LISTING_TYPE; totalListingCountFromCurrentCompany: number; listingResponsible: { id: string; email: string; }; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; contractDetails?: { currency?: CURRENCY_TYPE; rent?: number; totalMonthlyRent?: number; parkingRent?: number; deposit?: number; heatingCostsIncluded?: boolean; utilityCosts?: number; heatingCosts?: number; petsAllowed?: string; displayAmount?: number; hasCommission?: boolean; commission?: number; commissionNote?: string; }; }[PreviousLISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated)[NextLISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel)Last updated 26 days ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events/listing_created Crawling: https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel ============================================================ Title: LISTING_PUBLISHED_TO_CHANNEL | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingPublishedAction ; } interface IListingPublishedAction { id: string; title: string; companyId: string; type: LISTING_TYPE; channels: { type: string; internalId: string; status?: string; placementType?: { type: string; createdAt: string; }; isTypeInvestment?: boolean; }[]; listingResponsible: { id: string; email: string; }; }[PreviousLISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created)[NextLISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel Crawling: https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel ============================================================ Title: LISTING_UNPUBLISHED_FROM_CHANNEL | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events)- [LISTING_ACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_activated) - [LISTING_ARCHIVED](https://api-docs.everreal.co/webhooks/listing-events/listing_archived) - [LISTING_UPDATED](https://api-docs.everreal.co/webhooks/listing-events/listing_updated) - [LISTING_DEACTIVATED](https://api-docs.everreal.co/webhooks/listing-events/listing_deactivated) - [LISTING_CREATED](https://api-docs.everreal.co/webhooks/listing-events/listing_created) - [LISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel) - [LISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingUnpublishedAction; } interface IListingUnpublishedAction{ id: string; title: string; companyId: string; type: LISTING_TYPE; channels: { type: string; internalId: string; status?: string; placementType?: { type: string; createdAt: string; }; isTypeInvestment?: boolean; }[]; listingResponsible: { id: string; email: string; }; }[PreviousLISTING_PUBLISHED_TO_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_published_to_channel)[NextCandidates Events](https://api-docs.everreal.co/webhooks/candidates-events)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel Crawling: https://api-docs.everreal.co/webhooks/candidates-events ============================================================ Title: Candidates Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events)- [CANDIDATE_PARSED](https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed) - [LISTING_CANDIDATE_APPLIED](https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [CANDIDATE_PARSED](https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed)[LISTING_CANDIDATE_APPLIED](https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied)[PreviousLISTING_UNPUBLISHED_FROM_CHANNEL](https://api-docs.everreal.co/webhooks/listing-events/listing_unpublished_from_channel)[NextCANDIDATE_PARSED](https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/candidates-events Crawling: https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed ============================================================ Title: CANDIDATE_PARSED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events)- [CANDIDATE_PARSED](https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed) - [LISTING_CANDIDATE_APPLIED](https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IGetCandidateParsedAction; } interface IGetCandidateParsedAction { portalId: string; externalListingId: string; internalId?: string; candidateSource: string; integrationType: string; email: string; firstName: string; lastName: string; phoneNumber?: string; street?: string; number?: string; zipCode?: string; city?: string; employmentType?: { selectedValue?: EMPLOYMENT_TYPE; }; hasPets?: { checked?: boolean; answer?: string; }; netMonthlyIncome?: number; netMonthlyIncomeRanges?: { from?: number; to?: number; }; noTotalPeopleMovingIn?: number; householdPersons?: { count?: number; values?: IHouseholdPersonsValue[]; }; message?: string; desiredStartDate?: string; integration: { id: string; listingId: string; companyIntegrationId: string; internalId: string | number; type: string; externalListingId?: string; }; }[PreviousCandidates Events](https://api-docs.everreal.co/webhooks/candidates-events)[NextLISTING_CANDIDATE_APPLIED](https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed Crawling: https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied ============================================================ Title: LISTING_CANDIDATE_APPLIED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events)- [CANDIDATE_PARSED](https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed) - [LISTING_CANDIDATE_APPLIED](https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingCandidateApplied; } interface IListingCandidateApplied { id: string; candidateSource: CANDIDATE_SOURCE; email: string; firstName: string; lastName: string; listing: { id: string; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; }; }[PreviousCANDIDATE_PARSED](https://api-docs.everreal.co/webhooks/candidates-events/candidate_parsed)[NextListing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied Crawling: https://api-docs.everreal.co/webhooks/listing-contracting-events ============================================================ Title: Listing Contracting Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events)- [LISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed) - [LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed) - [LISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn) - [LISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [LISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed)[LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed)[LISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn)[LISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started)[PreviousLISTING_CANDIDATE_APPLIED](https://api-docs.everreal.co/webhooks/candidates-events/listing_candidate_applied)[NextLISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-contracting-events Crawling: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed ============================================================ Title: LISTING_CONTRACT_FLOW_SIGNED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events)- [LISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed) - [LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed) - [LISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn) - [LISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingContractFlowSignedAction; } interface IListingContractFlowSignedAction { id: string; metadata?: { unitId?: string; listingId?: string; candidateId?: string; }; contractData?: any; status?: CONTRACT_STATUS; contractFlowType: CONTRACT_FLOW_TYPE; contractFile?: { name?: string; resourcePath?: string; order?: number; size?: number; type?: string; }; auditTrailFile?: { name?: string; resourcePath?: string; order?: number; size?: number; type?: string; }; }[PreviousListing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events)[NextLISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed Crawling: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed ============================================================ Title: LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events)- [LISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed) - [LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed) - [LISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn) - [LISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingContractFlowPartiallySignedAction; } interface IListingContractFlowPartiallySignedAction { id: string; metadata?: { unitId?: string; listingId?: string; candidateId?: string; }; status?: CONTRACT_STATUS; contractFlowType: CONTRACT_FLOW_TYPE; contractFile?: { name?: string; resourcePath?: string; order?: number; size?: number; type?: string; }; }[PreviousLISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed)[NextLISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed Crawling: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn ============================================================ Title: LISTING_CONTRACT_FLOW_WITHDRAWN | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events)- [LISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed) - [LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed) - [LISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn) - [LISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingContractFlowWithdrawnAction; } interface IListingContractFlowWithdrawnAction { id: string; metadata?: { unitId?: string; listingId?: string; candidateId?: string; }; contractFlowType: CONTRACT_FLOW_TYPE; status?: CONTRACT_STATUS; }[PreviousLISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed)[NextLISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn Crawling: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started ============================================================ Title: LISTING_CONTRACT_FLOW_STARTED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events)- [LISTING_CONTRACT_FLOW_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_signed) - [LISTING_CONTRACT_FLOW_PARTIALLY_SIGNED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_partially_signed) - [LISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn) - [LISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingContractFlowStartedAction; } interface IListingContractFlowStartedAction { id: string; contractTemplateId?: string; metadata?: { unitId?: string; listingId?: string; candidateId?: string; }; contractData?: any; status?: CONTRACT_STATUS; contractFlowType: CONTRACT_FLOW_TYPE; contractFile?: { name?: string; resourcePath?: string; order?: number; size?: number; type?: string; }; }[PreviousLISTING_CONTRACT_FLOW_WITHDRAWN](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_withdrawn)[NextListing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started Crawling: https://api-docs.everreal.co/webhooks/listing-scheduling-events ============================================================ Title: Listing Scheduling Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)- [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin) - [LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested) - [LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate)[LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin)[LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate)[LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin)[LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested)[LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing)[PreviousLISTING_CONTRACT_FLOW_STARTED](https://api-docs.everreal.co/webhooks/listing-contracting-events/listing_contract_flow_started)[NextLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-scheduling-events Crawling: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate ============================================================ Title: LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)- [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin) - [LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested) - [LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingTimeslotBookingAction; } interface IListingTimeslotBookingAction { bookingId: string; invitationId: string; listing: { id: string; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; }; candidate: { id: string; email: string; }; timeslot: { id: string; startDate: DateOrString; duration: number; responsibleUser: { id: string; email: string; firstName: string; lastName: string; } }; }[PreviousListing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)[NextLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate Crawling: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin ============================================================ Title: LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)- [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin) - [LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested) - [LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingTimeslotBookingAction; } interface IListingTimeslotBookingAction { bookingId: string; invitationId: string; listing: { id: string; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; }; candidate: { id: string; email: string; }; timeslot: { id: string; startDate: DateOrString; duration: number; responsibleUser: { id: string; email: string; firstName: string; lastName: string; } }; }[PreviousLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate)[NextLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin Crawling: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate ============================================================ Title: LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)- [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin) - [LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested) - [LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingTimeslotBookingAction; } interface IListingTimeslotBookingAction { bookingId: string; invitationId: string; listing: { id: string; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; }; candidate: { id: string; email: string; }; timeslot: { id: string; startDate: DateOrString; duration: number; responsibleUser: { id: string; email: string; firstName: string; lastName: string; } }; }[PreviousLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin)[NextLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate Crawling: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin ============================================================ Title: LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)- [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin) - [LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested) - [LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingTimeslotBookingAction; } interface IListingTimeslotBookingAction { bookingId: string; invitationId: string; listing: { id: string; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; }; candidate: { id: string; email: string; }; timeslot: { id: string; startDate: DateOrString; duration: number; responsibleUser: { id: string; email: string; firstName: string; lastName: string; } }; }[PreviousLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate)[NextLISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin Crawling: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested ============================================================ Title: LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)- [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin) - [LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested) - [LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingNewTimeslotRequestedAction; } interface IListingNewTimeslotRequestedAction { listing: { id: string; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; }; candidate: { id: string; email: string; }; }[PreviousLISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin)[NextLISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested Crawling: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing ============================================================ Title: LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events)- [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booking_removed_admin) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_candidate) - [LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_timeslot_booked_admin) - [LISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested) - [LISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IWebhookDispatcher { uuid: string; operation: string; subdomain: string; language: string; createdAt: Date; data: IListingViewngInviteAction; } interface IListingViewngInviteAction { invitationId: string; listing: { id: string; property: { id: string; objectId: string; type: PROPERTY_TYPE; address: { zip: string; city: string; streetNumber: string; streetName: string; placeId: string; location?: { lat?: number; lng?: number; }; }; }; unit: { id: string; objectId: string; name: string; type: UNIT_TYPE; }; }; candidate: { id: string; email: string; }; }[PreviousLISTING_CANDIDATE_SCHEDULE_NEW_TIMESLOTS_REQUESTED](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_new_timeslots_requested)[NextProtocol Events](https://api-docs.everreal.co/webhooks/protocol-events)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing Crawling: https://api-docs.everreal.co/webhooks/protocol-events ============================================================ Title: Protocol Events | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events)- [PROTOCOL_COMPLETED](https://api-docs.everreal.co/webhooks/protocol-events/protocol_completed) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [PROTOCOL_COMPLETED](https://api-docs.everreal.co/webhooks/protocol-events/protocol_completed)[PreviousLISTING_CANDIDATE_SCHEDULE_INVITED_VIEWING](https://api-docs.everreal.co/webhooks/listing-scheduling-events/listing_candidate_schedule_invited_viewing)[NextPROTOCOL_COMPLETED](https://api-docs.everreal.co/webhooks/protocol-events/protocol_completed)Last updated 3 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/protocol-events Crawling: https://api-docs.everreal.co/webhooks/protocol-events/protocol_completed ============================================================ Title: PROTOCOL_COMPLETED | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks)- [Owner Events](https://api-docs.everreal.co/webhooks/owner-events) - [Property Events](https://api-docs.everreal.co/webhooks/property-events) - [Unit Events](https://api-docs.everreal.co/webhooks/unit-events) - [Listing Events](https://api-docs.everreal.co/webhooks/listing-events) - [Candidates Events](https://api-docs.everreal.co/webhooks/candidates-events) - [Listing Contracting Events](https://api-docs.everreal.co/webhooks/listing-contracting-events) - [Listing Scheduling Events](https://api-docs.everreal.co/webhooks/listing-scheduling-events) - [Protocol Events](https://api-docs.everreal.co/webhooks/protocol-events)- [PROTOCOL_COMPLETED](https://api-docs.everreal.co/webhooks/protocol-events/protocol_completed) - [Change log](https://api-docs.everreal.co/change-log) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? Copyinterface IProtocolAction { id:string companyId: string; protocolType?: string; protocolVersion?: string; protocolVersion: ProtocolVersion companyId: string propertyId: string unitId: string documentId: string additionalNotes: string moveInExtraInformation: MoveInExtraInformation moveOutExtraInformation: MoveOutExtraInformation sellingExtraInformation: SellingExtraInformation uploadsRootId: string draftId: string protocolType: ProtocolType createdAt: string updatedAt: string deletedAt: string property: { id:string } unit: { id : string } company: { id:string } rooms: [ProtocolRoom] meters: [ProtocolMeter] keysets: [ProtocolKeyset] persons: [ProtocolPerson] signatureAcknowledgementText: string } enum ProtocolType { MOVE_IN MOVE_OUT SELLING PRE_MOVE_OUT } enum ProtocolVersion { V1 V2 } type ProtocolMeter { id: string protocolId: string unitMeterId: string stand: string type: ProtocolMeterType number: string pictures: [File] } type ProtocolKeyset { id: id protocolId: string unitKeysetId: string quantity: number type: ProtocolKeysetType model: string pictures: [File] keyNumbers: [ProtocolKeyNumber] } type ProtocolPerson { id: id protocolId: string companyContactId: string email: string firstName: string lastName: string phoneNumber: string } [PreviousProtocol Events](https://api-docs.everreal.co/webhooks/protocol-events)[NextChange log](https://api-docs.everreal.co/change-log)Last updated 5 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/webhooks/protocol-events/protocol_completed Crawling: https://api-docs.everreal.co/change-log ============================================================ Title: Change log | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? This section provides a summary of the changes made to the API over time. For detailed information about specific releases, please refer to the "Released" section for past announcements and the "Upcoming" section for upcoming releases. [](https://api-docs.everreal.co/change-log/releases)Releases Released change logs [](https://api-docs.everreal.co/change-log/upcoming)Upcoming Release Announcements Announced upcoming releases [PreviousPROTOCOL_COMPLETED](https://api-docs.everreal.co/webhooks/protocol-events/protocol_completed)[NextReleases](https://api-docs.everreal.co/change-log/releases)Last updated 5 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log Crawling: https://api-docs.everreal.co/change-log/releases ============================================================ Title: Releases | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases)- [Introducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers) - [Enhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql) - [Enhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying) - [Enhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [Introducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers)[Enhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql)[Enhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying)[Enhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks)[PreviousChange log](https://api-docs.everreal.co/change-log)[NextIntroducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log/releases Crawling: https://api-docs.everreal.co/change-log/releases/introducing-mappers ============================================================ Title: Introducing Mappers | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases)- [Introducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers) - [Enhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql) - [Enhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying) - [Enhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? ### [](https://api-docs.everreal.co/change-log/releases/introducing-mappers#release-v2023.05.16)Release V2023.05.16 - Introducing [Mappers](https://api-docs.everreal.co/how-to-guide/everreal-data-import-process/import-mappers) for ERP integrations. **Deprecation Warnings** Part of cleaning our graphQL we are planing to deprecate following keys from our graphQL endpoints by Oct 2023 - Owner Module Copyraw: RawInput @deprecated(reason: "raw is deprecated. Use meta instead with a source.") externalId: String @deprecated(reason: "externalId is deprecated. Use externalOwnerId instead.") street: String @deprecated(reason: "street is deprecated. Use address.streetName instead.") number: String @deprecated(reason: "number is deprecated. Use address.streetNumber instead.") zipCode: String @deprecated(reason: "zipCode is deprecated. Use address.zipCode instead.") city: String @deprecated(reason: "city is deprecated. Use address.city instead.") country: String @deprecated(reason: "country is deprecated. Use address.country instead.") - Property Module Copyraw: PropertyRawInput @deprecated(reason: "raw is deprecated. Use meta instead with a source.") objectId: String @deprecated(reason: "objectId is deprecated. Use externalPropertyId instead.") owner: PropertyOwnerInput @deprecated(reason: "owner is deprecated. Use ownerId instead.") street: String @deprecated(reason: "address.street is deprecated. Use address.streetName instead.") number: String @deprecated(reason: "address.number is deprecated. Use address.streetNumber instead.") zip: String @deprecated(reason: "address.zip is deprecated. Use address.zipCode instead.") - Unit Module Copyraw: PropertyRawInput @deprecated(reason: "raw is deprecated. Use meta instead with a source.") unitId: String @deprecated(reason: "unitId is deprecated. Use externalUnitId instead.") objectId: String @deprecated(reason: "objectId is deprecated. Use externalUnitId instead.") propertyObjectId: String @deprecated(reason: "propertyObjectId is deprecated. Use externalPropertyId instead.") floorNumber: Float @deprecated(reason: "floorNumber is deprecated. Use floorNo instead.") - Tenant Module Copyraw: PropertyRawInput @deprecated(reason: "raw is deprecated. Use meta instead with a source.") externalId: String @deprecated(reason: "externalId is deprecated. Use externalTenantId instead.") nameOfTheUnit: String @deprecated(reason: "nameOfTheUnit is deprecated.") objectName: String @deprecated(reason: "objectName is deprecated.") startOfLease: String @deprecated(reason: "startOfLease is deprecated. Use contractStartDate instead.") endOfContract: String @deprecated(reason: "endOfContract is deprecated. Use contractEndDate instead.") - Listing Module CopyavailableFrom: Date @deprecated(reason: "ListingInformation.availableFrom will be moved to the main level.") [PreviousReleases](https://api-docs.everreal.co/change-log/releases)[NextEnhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log/releases/introducing-mappers Crawling: https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql ============================================================ Title: Enhancements for GraphQL | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases)- [Introducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers) - [Enhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql) - [Enhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying) - [Enhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? - New fields are added to application data for candidate query. Copytype ApplicationData { ... existingKeys+ netMonthlyIncomeRanges: NetMonthlyIncomeRange netMonthlyIncome: Float grossMonthlyIncome: Float salutation: String phoneNumber: String address: CandidateAddress } type CandidateAddress { streetNumber: String streetName: String city: String zipCode: String country: String } type NetMonthlyIncomeRange { from: Int to: Int } - Ability to send phoneNumber for tenant mutation - Ability to delete tenants along with contracts associated with tenants Copytype Mutation { removeTenant(id: String, shouldDeleteContracts: Boolean): AsyncEventResponse } [PreviousIntroducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers)[NextEnhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying)Last updated 5 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql Crawling: https://api-docs.everreal.co/change-log/releases/enhancements-for-querying ============================================================ Title: Enhancements for Querying | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases)- [Introducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers) - [Enhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql) - [Enhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying) - [Enhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? - Introducing Identity for Owners and Tenants, Now you can add owners/tenants with same email unless an Identity is matched. ie, we consider externalId_firstName_lastName_email as an identity it should be unique. So If you need multiple tenant/owner with same email Id, make a change to the identity eg: different externalId's. - Added abilities to do query modules with EverReal UUID for the following module and results will be returned in an array. **Owner Query** Copyinput OwnersFilter { ... existingFilters+ id: String }**Property Query** Copyinput PropertyFilter { ... existingFilters+ id: String propertyId: String @deprecated(reason: "propertyId is deprecated. Use id instead.") }**Unit Query** Copyinput UnitsFilter { ... existingFilters+ id: String }**PropertyGroup Query** Copyinput PropertyGroupFilter { ... existingFilters+ id: String }**Candidate Query** Copyinput CandidateFilter { ... existingFilters+ id: String }**Tenant Query** Copyinput TenantFilter { ... existingFilters+ id: String }[PreviousEnhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql)[NextEnhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log/releases/enhancements-for-querying Crawling: https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks ============================================================ Title: Enhancements for Webhooks | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases)- [Introducing Mappers](https://api-docs.everreal.co/change-log/releases/introducing-mappers) - [Enhancements for GraphQL](https://api-docs.everreal.co/change-log/releases/enhancements-for-graphql) - [Enhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying) - [Enhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? - We have improved webhook payload for scheduled events with more data. The changes applied to the following webhooks, LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_CANDIDATE LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKING_REMOVED_ADMIN LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_CANDIDATE LISTING_CANDIDATE_SCHEDULE_TIMESLOT_BOOKED_ADMIN Detail payload can be found in the [scheduling webhook section](https://api-docs.everreal.co/webhooks/listing-scheduling-events) Copy...existingKeys timeslot: { ...existingKeys responsibleUser: { id: String; email: String; firstName: String; lastName: String; } }[PreviousEnhancements for Querying](https://api-docs.everreal.co/change-log/releases/enhancements-for-querying)[NextUpcoming](https://api-docs.everreal.co/change-log/upcoming)Last updated 5 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks Crawling: https://api-docs.everreal.co/change-log/upcoming ============================================================ Title: Upcoming | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming)- [Introduced Querying Protocol in GraphQL](https://api-docs.everreal.co/change-log/upcoming/introduced-querying-protocol-in-graphql) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? [Introduced Querying Protocol in GraphQL](https://api-docs.everreal.co/change-log/upcoming/introduced-querying-protocol-in-graphql)[PreviousEnhancements for Webhooks](https://api-docs.everreal.co/change-log/releases/enhancements-for-webhooks)[NextIntroduced Querying Protocol in GraphQL](https://api-docs.everreal.co/change-log/upcoming/introduced-querying-protocol-in-graphql)Last updated 2 years ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log/upcoming Crawling: https://api-docs.everreal.co/change-log/upcoming/introduced-querying-protocol-in-graphql ============================================================ Title: Introduced Querying Protocol in GraphQL | EverReal ============================================================ - [Introduction](https://api-docs.everreal.co/) - [Authentication](https://api-docs.everreal.co/master) - [Rate limiting](https://api-docs.everreal.co/rate-limiting) - [Helpers](https://api-docs.everreal.co/helpers) - [How to guide](https://api-docs.everreal.co/how-to-guide) - [Endpoints](https://api-docs.everreal.co/endpoints) - [Webhooks](https://api-docs.everreal.co/webhooks) - [Change log](https://api-docs.everreal.co/change-log)- [Releases](https://api-docs.everreal.co/change-log/releases) - [Upcoming](https://api-docs.everreal.co/change-log/upcoming)- [Introduced Querying Protocol in GraphQL](https://api-docs.everreal.co/change-log/upcoming/introduced-querying-protocol-in-graphql) [Powered by GitBook](https://www.gitbook.com/?utm_source=content&utm_medium=trademark&utm_campaign=-MgL3i0-8YP9K1HyrHy8)On this pageWas this helpful? - Ability to retrieve protocol information from EverReal. Copytype Query { protocols(input: ProtocolFilterListPaging): [Protocol] } - Deprecated MOVE_IN_PROTOCOL_COMPLETED and MOVE_OUT_PROTOCOL_COMPLETED` events in favour of PROTOCOL_COMPLETED event. In all instances where you rely on the deprecated events above, make use of the newly introduced PROTOCOL_COMPLETED event. [PreviousUpcoming](https://api-docs.everreal.co/change-log/upcoming)Last updated 5 months ago Was this helpful? ============================================================ Content extracted from: https://api-docs.everreal.co/change-log/upcoming/introduced-querying-protocol-in-graphql