contacts_create
ChatGPTCreate a new contact. If a contact with the same email already exists, nothing is created and the existing one is returned; pass allow_duplicate=true only when the user confirms it is a different person.
contacts_delete
ChatGPTDelete a contact. Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
contacts_get_details
ChatGPTGet full contact details by ID: phones, language, address, lead data, notes, linked properties, and the contact's deals and upcoming/past visits.
contacts_search
ChatGPTRead-only. Search or list contacts in the company by name, email, tags, or language.
contacts_update
ChatGPTUpdate contact fields. Only the fields you send change. phone sets the primary number and keeps the others; phones replaces the whole list.
deals_add_contact
ChatGPTLink a contact to a deal
deals_add_property
ChatGPTLink a property to a deal
deals_change_stage
ChatGPTMove a deal to another stage of its pipeline. Stages per deal type, in order: sale: new → qualification → visit_scheduled → visit_done → offer_made → offer_accepted → compromis_signed → conditions_pending → acte_signed → cancelled; rental: new → qualification → visit_scheduled → visit_done → application_submitted → application_approved → lease_signed → etat_des_lieux → keys_handed_over → cancelled; valuation: new → qualification → visit_scheduled → visit_done → report_drafting → report_delivered → cancelled; vefa: new → qualification → visit_scheduled → visit_done → reservation_signed → financing_approved → notary_appointment → acte_signed → construction_monitoring → pre_delivery → delivery → cancelled; other: new → qualification → visit_scheduled → visit_done → offer_made → offer_accepted → compromis_signed → conditions_pending → acte_signed → cancelled. Moving to "cancelled" needs the user's confirmation. To close a deal as won (acte_signed, keys_handed_over, report_delivered or delivery, depending on the type) use deals_close. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
deals_close
ChatGPTClose a deal as won, like the app's Close deal page: moves it to its pipeline's final stage (sale/other: acte_signed, rental: keys_handed_over, valuation: report_delivered, vefa: delivery), records the closing price and the current user as closer, and marks linked properties sold (sale, vefa) or rented (rental). Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
deals_create
ChatGPTCreate a new deal. Stages per deal type, in order: sale: new → qualification → visit_scheduled → visit_done → offer_made → offer_accepted → compromis_signed → conditions_pending → acte_signed → cancelled; rental: new → qualification → visit_scheduled → visit_done → application_submitted → application_approved → lease_signed → etat_des_lieux → keys_handed_over → cancelled; valuation: new → qualification → visit_scheduled → visit_done → report_drafting → report_delivered → cancelled; vefa: new → qualification → visit_scheduled → visit_done → reservation_signed → financing_approved → notary_appointment → acte_signed → construction_monitoring → pre_delivery → delivery → cancelled; other: new → qualification → visit_scheduled → visit_done → offer_made → offer_accepted → compromis_signed → conditions_pending → acte_signed → cancelled. The stage must belong to the deal type's pipeline; a deal cannot be created already closed or cancelled.
deals_delete
ChatGPTDelete a deal and its attached files. To end a deal normally use deals_close or cancel it with deals_change_stage. Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
deals_get_details
ChatGPTGet deal details: stage, type, price, priority, dates, notes, linked contacts, properties and projects.
deals_search
ChatGPTList deals, filter by stage, type, contact or property. Stages per deal type, in order: sale: new → qualification → visit_scheduled → visit_done → offer_made → offer_accepted → compromis_signed → conditions_pending → acte_signed → cancelled; rental: new → qualification → visit_scheduled → visit_done → application_submitted → application_approved → lease_signed → etat_des_lieux → keys_handed_over → cancelled; valuation: new → qualification → visit_scheduled → visit_done → report_drafting → report_delivered → cancelled; vefa: new → qualification → visit_scheduled → visit_done → reservation_signed → financing_approved → notary_appointment → acte_signed → construction_monitoring → pre_delivery → delivery → cancelled; other: new → qualification → visit_scheduled → visit_done → offer_made → offer_accepted → compromis_signed → conditions_pending → acte_signed → cancelled. To list or count ALL deals, set fetch_all=true so every page is included.
deals_update
ChatGPTUpdate a deal's title, notes, type, priority, asking price, expected closing date or commission. Only the fields you send change; send null to clear one. Change the stage with deals_change_stage, close with deals_close.
files_create_folder
ChatGPTCreate a new folder
files_delete_file
ChatGPTDelete a file, image or video. An image still used by a property, a project cover or the company branding is refused. Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
files_delete_folder
ChatGPTDelete an empty folder (move or delete its contents first). Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
files_get_file_details
ChatGPTGet file metadata and a download URL (documents: a link valid for 5 minutes; images and videos: their public URL). To read what's inside a file, use files_read_file.
files_get_folder_by_path
ChatGPTNavigate to folder by path e.g. /properties/my-folder, and list its subfolders and files.
files_list_folder_contents
ChatGPTList files and subfolders in a folder
files_read_file
ChatGPTRead the contents of a Habiata file: spreadsheets (xlsx, xls, ods, csv) as CSV rows with a header, PDFs and Word documents as text, plain text files as-is, images as an image you can look at. Spreadsheets return up to 200 rows per call; page with start_row, pick a tab with sheet.
files_search_files
ChatGPTSearch the company's files (documents, images, videos) by name, description or tag, across every folder. Pass folder_id to look in one folder only. Newest first.
files_search_folders
ChatGPTSearch folders by name
files_update_file_metadata
ChatGPTUpdate file name, description, or tags
leads_convert
ChatGPTConvert (approve) a lead: links or creates the CRM contact, creates a deal with the lead's property, and a search mandate when the lead asked for similar properties. Only when the user asks to convert/approve a lead.
leads_get_details
ChatGPTGet a lead's full details: contact info, message, budget, financing, timeline, score, the properties/projects they asked about, and the contact/deal created when converted.
leads_search
ChatGPTRead-only. List or search incoming property enquiries (leads) in the company and return counts per stage (pending_review = New, contacted, qualified, on_hold, approved = Converted (contact + deal created), rejected.).
leads_set_status
ChatGPTMove a lead to another stage (New, Contacted, Qualified, On hold, Rejected). To convert a lead into a contact + deal use leads_convert instead. Converted leads can't be moved.
list_companies
ChatGPTRead-only. Returns the name and company_id of each company the current user belongs to. Takes no input and changes nothing.
opportunities_create_search
ChatGPTCreate a property search (buyer/tenant criteria) for a contact. Matching properties become opportunities.
opportunities_delete_search
ChatGPTDelete a property search mandate and its untouched matches. To pause it instead, use opportunities_update_search with is_active=false. Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
opportunities_get_search
ChatGPTGet one property search mandate: every criterion, the contact, status and match count.
opportunities_list_matches
ChatGPTRead-only. List matched opportunities (properties matched to a contact's search mandate) with match score, distance, and follow-up status.
opportunities_list_searches
ChatGPTRead-only. List saved property search mandates in the company with their criteria, linked contact, and match count.
opportunities_preview_search
ChatGPTCount and preview the properties that search criteria would match, without saving a search.
opportunities_update_match
ChatGPTSet the follow-up status of a matched opportunity: NEW, VIEWED, CONTACTED (contact was told about the property), INTERESTED, NOT_INTERESTED or CLOSED.
opportunities_update_search
ChatGPTUpdate a property search. Only the fields you send change; send an array as [] or a value as null to clear it.
projects_add_property
ChatGPTAdd existing properties to a project. Pass every property for the project in one call rather than one call per property.
projects_create
ChatGPTCreate a development project that groups properties. project_type is apartment_block (a residence of flats) or housing_project (a subdivision of houses); omit it to let portals infer the type.
projects_delete
ChatGPTDelete a project. Only an empty project can be deleted (move or delete its properties first); the default project cannot. Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
projects_get_details
ChatGPTGet a project by ID: name, status, type, property counts, and description. Does not include the units — use projects_list_properties for those.
projects_list_properties
ChatGPTList the properties (units) in a project. To list or count ALL units, set fetch_all=true so every page is included.
projects_search
ChatGPTList or search development projects (a residence or housing programme that groups properties). The company list is returned in full — it is not paginated. Filter by name, status (active, draft, archived), or type (apartment_block, housing_project). Omit status for the same set as the Projects page; pass status=archived to include archived projects.
projects_update
ChatGPTUpdate a project's name, type, English description, or archive state. Setting archived=true needs the user's confirmation. The default project cannot be archived, and neither can a project with properties live on a portal. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
properties_create
ChatGPTCreate a property (listing). Needs title, street address, city, country and property_type; everything else is optional. Price is in EUR in price. Pass project_id to create the property as a unit of a project. Map coordinates are looked up from the address unless latitude/longitude are given; without them the property is left out of radius searches. The property is not published to any portal.
properties_delete
ChatGPTDelete a property. Refused while it is live on a portal (unpublish it in the app first). Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
properties_get_details
ChatGPTGet property details by ID: price (EUR, monthly for rentals), address, rooms, areas, energy class, year built, status (draft/live/archived), project, portals, features and description.
properties_search
ChatGPTSearch and list properties. The price is in the price field (EUR). Supports filters (price, rooms, area, location, radius, energy class, amenities, transaction type) and sorting — e.g. to find the most valuable properties use sort_by='price', sort_order='desc'. To list or count ALL properties, set fetch_all=true so every page is included.
studio_edit_photo
ChatGPTAdjust brightness, contrast, saturation, warmth, color filter, rotation, flip, or aspect-ratio crop on a company file or property photo, and save the edited copy to Habiata Files.
studio_generate_image
ChatGPTStart a Habiata Studio image enhancement, virtual staging, cleanup, or 4K upscale job for a company file or property photo.
studio_generate_video
ChatGPTStart a Habiata Studio video animation job from a company file or property photo.
studio_get_job_status
ChatGPTCheck the status of a Habiata Studio image or video generation job and save the completed media file into the company's Studio folder in Habiata Files.
studio_list_creations
ChatGPTList Habiata Studio AI image and video creations for the current company, including status (processing, ready, failed), style, prompt, output URL, and saved file ID.
studio_list_presets
ChatGPTList all Habiata Studio capabilities: AI photo enhancement/staging styles, AI video camera motion styles, and built-in watermark presets (agency branding, EU AI Act compliance badges, and Sold/Rented/Sous-compromis ribbons).
visits_create
ChatGPTSchedule a visit. Dates: ISO 8601. Give local wall-clock time without an offset (e.g. 2026-10-09T10:00) to use the user's time zone, or include an offset. end_date sets the block length (default 60 min). Use slots to book several contacts at different times inside the same block.
visits_delete
ChatGPTDelete (cancel) a visit. Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
visits_search
ChatGPTRead-only. List property visits in the company (newest first) with date/time in the user's time zone, linked property, and contacts.
visits_update
ChatGPTReschedule or update visit details. Dates: ISO 8601. Give local wall-clock time without an offset (e.g. 2026-10-09T10:00) to use the user's time zone, or include an offset. Passing slots replaces the visit's slot list (keep an existing slot by sending its id).
watermark_apply
ChatGPTApply a company watermark template, built-in watermark preset, or custom text/logo layers to a company file or property photo, and save the watermarked copy to Habiata Files.
watermark_delete_template
ChatGPTDelete a saved company watermark template by template_id. Needs the user's confirmation. Where confirmation is needed, call without confirmation_token first to preview the effects, then call again with the returned token after the user approves.
watermark_list_templates
ChatGPTList saved company watermark templates, built-in watermark presets (agency logos, EU AI Act compliance badges, Sold/Rented/Sous-compromis ribbons), and uploaded watermark logo files.
watermark_save_template
ChatGPTCreate or update a reusable company watermark template in Habiata Studio with text and/or logo layers, or from a built-in preset.