Listing Management
      Back to home
      1. Rentsync Help Centre
      2. Listing Management

      Using Rentsync's Webhook

      The Rentsync Webhook transmits data between Rentsync and third-party systems.

      Rentsync uses webhooks to notify your application when an asynchronous event (in this case, incoming lead data from an ILS directory) happens in your account. Lead data can be forwarded to your system of choice based on your setup.

      Begin using webhooks with your Rentsync integration in just two steps:

      1. Create a webhook endpoint on your server.
        • For the receiving leads this must be a POST method.
        • Your webhook should communicate with your system of choice’s APIs. This is a one-time technical setup done by a Software Developer from your organization.
      2. Register the endpoint with Rentsync to go live.
        • Click "Listing Management" from the main menu. 
        • Choose "Integrations" from the secondary menu.
        • Provide the Key and Endpoint URL. Click the “Save” button.

      Before you turn the Webhook “on”, you can use the testing tool to send a test lead as a way to validate your setup.

      Once the “Send ILS Leads via Webhook” option (toggle) is “on” and saved, Rentsync’s webhook will automatically transmit data related to leads pertaining to your customer ID.

      The request body sent will be of this format:

      {
        "auth": {
          "key": "2343SDaSDSDSd232323"
        },
        "data": {
          "firstName": "Jane",
          "lastName": "Doe",
          "fullname": "Jane Doe",
          "phone": "1231231234",
          "source": "rentsync",
          "parser": "rentsyncParser001",
          "email": "jane@doe.com",
          "inboundEmailId": 1234567,
          "comment": "This is a test comment",
          "sentAt": "Mon Jan 01 2021 10:10:00 GMT+0000 (Coordinated Universal Time)",
          "adUrl": "https://www.testurl.com?id=1234",
          "adIdentifier": "1234",
          "clientKey": "rentsync-client",
          "recipientEmail": "noreply@rentsync.com",
          "buildingId": 12345,
          "propertyName": "Jane Doe Property Rental",
          "propertyEmail": "jd-Leads@jdproperties.com",
          "propertyImportId": "57234",
          "isPromoted": true,
          "promotionType": "Random Promotion",
          "moveInDate": "2024-01-01"
        }
      }

      This request sent to your endpoint can be processed as you wish. It can be stored in a database, or displayed real-time on an incoming leads feed.