Leads synchronization service

Partners that need to report leads can write a webservice using these specifications.

Get start

You are free to publish your entry point URLs, just need to inform us and listening on http POST method.

Entry point

We need to know the URL

[POST] https://partner.com/service-name/contact

Request Header

Anytime we push a lead we will send these http headers:

Content-type: application/json
Accept: application/json

Request body

Any push will have this JSON request body:

{
    "agencyEmail": "nobody@nowhere.net",
    "agencyExternalId": "1234",
    "agencyId": 5678,
    "listingId": 87654321,
    "listingExternalId":"ES-RIF-001",
    "leadId": 98765432,
    "date": "2021-03-18 16:11:04",
    "email": "who@tardis.net",
    "msg": "I'm interested to this real estate, can I have more info?",
    "name": "Doctor Who",
    "referrer": "https://www.immobiliare.it/annunci/87654321/",
    "remote_ip": 0.0.0.0,
    "src": "immobiliare.it",
    "phone": "3441234567"
}

Response

Your services need to answer with a http status code: any response with a 2xx class status code is a success. On the response body we need a JSON block, in armony with the http status code.

Status 200

{
    "code": 2000,
    "message": "success"
}

Take care, if http status code is 200 please avoid:

{
    "code": 4040,
    "message": "listing non found"
}

Because we will reach this answer as a success.

Status 404

{
    "code": 4040,
    "message": "listing non found"
}

or

{
    "code": 4400,
    "message": "real estate agency non found"
}

The code element into the JSON is different from the http status code but it is in armony with it.

Status 500

{
    "code": 5000,
    "message": "server error"
}

Response codes

2025 Indomio.com

• Get start
  • Entry point
  • Request Header
  • Request body
  • Response