En déploiementÉtat au 19 novembre 2026
Demandes en JSON par e-mail
Chaque demande arrive dans un e-mail à l’adresse que tu nous donnes. Le texte de l’e-mail est le JSON, ton logiciel le lit.
L’e-mail
Un e-mail par nouvelle demande, en texte brut UTF-8, dont tout le texte est un objet JSON. Il part à l’adresse que tu nous indiques pour tes annonces. L’objet est « Homematch Anfrage » suivi de l’inquiryId, et le Reply-To est la personne qui demande. Les messages suivants n’arrivent pas en JSON.
Répondre directement
L’e-mail et le téléphone de la personne sont réels, pour que ton agence puisse répondre directement.
Champs
versionstring- Toujours "1". Nous annoncerons toute nouvelle version.
sourcestring- Toujours "homematch".
inquiryIdstring- Identifiant unique de la demande. S’il arrive deux fois, c’est la même demande.
sentAtstring- Quand la demande a été envoyée (ISO 8601).
listing.providerReferencestring | null- Ta propre référence d’objet, issue de ton flux.
listing.homematchListingIdstring- Le numéro de l’annonce sur Homematch.
listing.urlstring- Le lien vers l’annonce.
listing.addressstring | null- L’adresse de l’objet, sur une ligne.
inquirer.firstNamestring | null- Prénom.
inquirer.lastNamestring | null- Nom.
inquirer.emailstring- E-mail de la personne qui fait la demande.
inquirer.phonestring | null- Téléphone, si indiqué.
inquirer.languagestring- Langue de la personne : de, fr, it ou en.
messagestring- Le message, tel qu’il a été écrit.
profileobject | null- Le profil de candidature, si la personne en joint un.
profile.dealstring- rent ou sale.
profile.topicsstring[]- Quelles informations le profil contient, jamais les informations elles-mêmes.
conversationUrlstring | null- Toujours null par e-mail : réponds directement à l’adresse de la personne.
Ce que topics peut indiquer
Seulement le type d’information, jamais la valeur :
- household
- pets
- employment
- income
- moveIn
- purchasePurpose
- equity
- financing
Exemple
{
"version": "1",
"source": "homematch",
"inquiryId": "7d0f3c2a5b1e4c8d9f6a2e4b8c1d0a93",
"sentAt": "2026-11-19T13:32:05Z",
"listing": {
"providerReference": "R-1234",
"homematchListingId": "1234567",
"url": "https://homematch.ch/listings/1234567",
"address": "Musterstrasse 12, 8000 Zürich"
},
"inquirer": {
"firstName": "Anna",
"lastName": "Muster",
"email": "anna.muster@example.invalid",
"phone": "+41 79 000 00 00",
"language": "de"
},
"message": "Guten Tag, ist die Wohnung noch frei? Ich würde sie gerne besichtigen.",
"profile": {
"deal": "rent",
"topics": [
"household",
"employment",
"income",
"moveIn"
]
},
"conversationUrl": null
}Prêt à tester ?
Nous te donnons accès à notre environnement de test et vérifions ta connexion avant sa mise en ligne.