Node detail //realtor

In this node you can specify the realtors linked to the listing

Real Estate Realtor (this document)

/realtor

Create/update realtor

You can create or update a realtor by sending a request to the following endpoint:

PUT /ws/import/ies/company/realtor

example:

<agent>
    <email>agenzia@email.it</email>
    <realtors>
        <realtor external-id="age-01">
            <firstname>Nobody</firstname>
            <surname>Nothing</surname>
            <role>agent</role>
            <connections>
                <connection type="email">nobody@nowhere.com</connection>
            </connections>
        </realtor>
    </realtors>
</agent>

The agency can always create realtors or users directly from their personal area in ImmobiliarePro platform or in Getrix.

Use Realtors in Listings

You can link a listing to a realtor that you have previously created.

You can reference the realtor by externalId:

Example:

<agent>
    <office-name><![CDATA[Testing Real estate agency]]></office-name>
    <email>nothing@nowhere.com</email>
      <realtors>
          <realtor external-id="dude-01">
          </realtor>
      </realtors>
  </agent>

Alternatively, you can reference the realtor by id:

<agent>
    <office-name><![CDATA[Testing Real estate agency]]></office-name>
    <email>nothing@nowhere.com</email>
      <realtors>
          <realtor id="123456">
          </realtor>
      </realtors>
  </agent>

Retrieve realtors

Retrieve Company ID

You can retrieve the company ID by including the group name in the following request:

GET /ws/export/group/{groupName}/company

Response example:

{
"id": 11111,
"uuid": "eb5791ff-34fc-5eeb-b61e-e8446a6a04f0",
"externalId": "55555",
"name": "Nome Agenzia Srl",
"username": "email@agenzia.it",
"group": "gruppo-ws",
"status": "active"
}

Retrieve Company Realtors

You can retrieve all information about a company’s realtors by sending a GET request to this endpoint:

GET /ws/export/company/{companyId}

Response example:

{
  "id": 77777,
  "uuid": "7e68bd3c-189f-5b6d-b0a2-49c329e2c9b7", 
  "externalId": "age-01",
  "email": "indirizzo_email@agente.com",
  "firstName": "nobody",
  "lastName": "nothing",
  "owner": false,
  "status": "active"
}

Delete a Realtor

You can delete a realtor by sending a DELETE request to this endpoint:

DELETE /ws/import/ies/company/realtor

There are two ways to specify the realtor you want to delete:

By Realtor ID

DELETE /ws/import/ies/company/realtor/123456?mode=hard

By Realtor externalId

DELETE /ws/import/ies/company/realtor?externalId=age-01&mode=hard

//agent/realtors

Node container of the brokers/realtors.

//agent/realtors/realtor

Broker/Realtor. @external-id can be used to bind this element with your CRM.

//agent/realtors/realtor/firstname

Broker/Realtor firstname

//agent/realtors/realtor/surname

Broker/Realtor lastname

//agent/realtors/realtor/role

Broker/Realtor role. Please use the value agent.

//agent/realtors/realtor/connections

Container node to connect with the Broker/Realtor.

//agent/realtors/realtor/connections/connection

Broker/Realtor connection. @type attribute can assume these values:

2025 Indomio.com

English Italiano