Working with Webhooks

Setting up webhook integrations

Updated over a week ago

You can send data from PropertyRadar to a URL destination of your choosing, using webhooks. Sending data from PropertyRadar Automations or by using the Export to Integrations selection, to software you create, allows for a vast potential of integrations with your business processes.

To work with webhooks using PropertyRadar, use the following the steps:

Build Your Software

To integrate with PropertyRadar using webhooks, you will need to develop software, likely with a software engineer, to accept the data from PropertyRadar and use it for your business needs.

Although we don't yet offer sample code for creating a webhook server, there are many examples on the web; review this Go example, or checkout a Python code example. Even with these starting points, creating a useful Webhook server to do something with the data we send requires software development skills.

Before developing custom software, we recommend that you first use https://webhook.site to provide you with a Webhook URL which you can add to PropertyRadar. Then, use our Send a Test Record feature to see how it works, and view a sample of the data we send as received by a webhook server.

The Data Available for Zapier and Webhooks Integrations is provided for the fields and values available with PropertyRadar exports.

IMPORTANT
Although we strive to provide cutting-edge technology, we cannot provide software development assistance. Before using your own code, be sure to Test your Webhook.

Add a New Webhook

You can add a webhook using the Account Settings window.

  1. In PropertyRadar, navigate to your Account Settings. At the bottom of the page is the Integrations & API section, click the Add Integration button.
    The Add Integration dialog box is displayed:

    Add Integration with Webhooks


  2. In the Webhooks section, type the following to set up your Webhook integration:
    Webhook Name - a name for your Webhook Integration
    Webhook URL - the URL where you want PropertyRadar to send data. You will need to create or provide the software behind your URL.
    Webhook Secret - an optional safety measure to make sure only PropertyRadar can send data to your Webhook URL. To use it, you will need to setup your page to only accept the data if the secret is included.

  3. Click Add Webhook.
    The webhook is added in the Integrations & API section of the Account Settings window.

In the Integrations & API section of the Account Settings window, you can click the Integration Name to:

Test Your Webhook

Before using your own code for the Integration, be sure to test the connection first. Avoid incomplete or wrong data exports by sending a test record.

To send a test record:

  1. From the Integrations & API section of the Account Settings window, click the Integration Name for the Webhook you want to test:


  2. In the dialog box displayed, click Send Test Record.

  3. Check your website that the test record was sent successfully.

Troubleshooting

  • IMPORTANT: Automations do not happen immediately. Once alert agents (running in the background) are triggered into action, there are current server loads and other factors that can affect timing. It may take up to 30 minutes (although usually faster) for your records to get pushed to your new List.

  • If a trigger has occurred (e.g. new match, status change), but the event is not showing in recent events after 30 minutes, then the problem is with the automation itself, and likely has nothing to do with the action (webhook, alert, etc). Contact Customer Support if this issue arises.

  • Although we strive to provide cutting-edge technology, we cannot provide software development assistance.

  • Send a Test Record to https://webhook.site/ as a first step in understanding the data we send. You can inspect, test, and automate any incoming HTTP request.

Delete a Webhook

  1. From the Integrations & API section of the Account Settings window, click the Integration Name for the webhook you want to delete.

  2. In the dialog box displayed, click Delete.
    The webhooks connected with that Integration Name are removed.

Use Webhooks

There are two ways to add webhooks in PropertyRadar, see below in Using the Export to Integration selection, or Using an Automation. Use Export to Integration to send records via a webhook

Using an Automation

Setting up your Automation(s) for Webhook Integration will send a property to your URL, each time your automation is triggered.

We include information in the record to tell you what triggered the event and provide details on the data that changed to cause the trigger if applicable. Review the fields TriggerType, NewRecordType, NewAttribute, and Change1-3 explained in Data Available for Zapier and Webhooks Integrations.

To set up an automation for webhook integation:

  1. From My LIsts, select Automations for the List you want to add webhooks.
    The List_Name Automations window is displayed.

  2. In the Enable Automations section, select Enabled.

  3. In the Triggers section, select the triggers you want for the automation.

  4. Select Alerts for how you want to receive automation alerts, and the contact to receive the alerts.

  5. In the Integrations section, select the Webhook you want to use for the integration with this automation.

  6. Click Save to begin using the Webhook integration for the automation.

Using Export to Integration

Using the Export to Integration selection in the Actions... menu, sends each property currently selected to the webhook integration.

  1. Using Actions... menus throughout PropertyRadar, select Export to Integration.

    Export to Integrations from Actions Menu


    The Export to Integration dialog box is displayed:

    Select an Integration to Export to.


  2. Select a Webhook Integration from the menu, and click Continue.
    The Complete Export dialog box is displayed, where you verify that your selections are final and non-refundable for export, then clicking Purchase.

    Review the Export in progress dialog box for important information, then click OK:

    Exporting Integration goes into queue

Data for each property selected will be sent to your selected Webhook.

Sample Payload

Review the sample payload for the webhook event below.

Note that if you include the ListName field in you webhook

{ 
"ListName": "Example New Record List",
"RadarID": "P12345A01",
"PropertyURL": "https://goradar.it/P12345A01",
"APN": "R221388",
"County": "POWELL",
"Address": "307 LAMBERTS BRANCH ROAD",
"City": "SALT LAKE CITY",
"State": "UT",
"EstimatedValue": "434668",
"AVM": "307698",
"FirstLoanAmount": "411726",
"FirstAmount": "364209",
"FirstLoanDate": "2004-12-02",
"FirstDate": "2004-12-02",
"FirstLoanLender": "BOB DOE",
"FirstLenderOriginal": "BOB DOE",
"FirstLoanPurpose": "CashOut",
"FirstPurpose": "CashOut",
"FirstLoanRate": "",
"FirstRate": "",
"LegalOwner": "DAMIAN A & MELLISSA ANN BRANCH TRUST OF 2015",
"Owner": "DAMIAN A & MELLISSA ANN BRANCH TRUST OF 2015",
"OwnerFirstName": "DAMIAN",
"OwnerLastName": "BRANCH",
"OwnerSpouseFirstName": "KIMBERLY BRANCH",
"MailingAddress": "P.O. BOX 12345",
"OwnerAddress": "P.O. BOX 12345",
"MailingCity": "EDEN",
"OwnerCity": "EDEN",
"MailingState": "UT",
"OwnerState": "UT",
"MailingZip": 85151,
"YearBuilt": "2008",
"SqFt": "3036",
"Beds": "5",
"Baths": "1",
"Units": "3",
"LotSize": "14319",
"LotSizeAcres": "0.32871900826446",
"OwnerZipFive": 85151,
"OpenLoans": 1,
"EquityPercent": 30,
"NumberLoans": 1,
"PrimaryContactEmail": "realtyteam@invalid.com",
"PrimaryEmail1": "realtyteam@invalid.com",
"PrimaryContactFirst": "DAMIAN",
"PrimaryFirstName": "DAMIAN",
"PrimaryContactLast": "BRANCH",
"PrimaryLastName": "BRANCH",
"PrimaryContactPhone": "999-999-9999",
"PrimaryPhone1": "999-999-9999",
"PrimaryMobilePhone1": "999-999-9999",
"SecondaryFirstName": "KIMBERLY",
"SecondaryLastName": "BRANCH",
"SecondaryMobilePhone1": "999-999-9999",
"SecondaryPhone1": "999-999-9999",
"SecondaryEmail1": "realtyteam.branch@invalid.com",
"PropertyType": "MFR",
"PType": "MFR",
"PurchaseAmount": "",
"LastTransferValue": "",
"PurchaseDate": "2003-11-12",
"LastTransferRecDate": "2003-11-12",
"PurchaseSeller": "",
"LastTransferSeller": "",
"PurchaseType": "Market",
"LastTransferType": "Market",
"Zip": 84104,
"ZipFive": 84104,
"PhotoURL1": "https://photos.goradar.it/123e4567-e89b-12d3-a456-426655440000.jpg",
"AnnualTaxes": "",
"AssessedValue": "",
"AvailableEquity": "",
"DaysOnMarket": "",
"DefaultAmount": "",
"DefaultAsOf": "",
"DOTPosition": "",
"EstimatedTaxRate": "",
"ForeclosureRecDate": "",
"ForeclosureStage": "",
"inForeclosure": "No",
"isListedForSale": "",
"isMailVacant": "",
"isSameMailingOrExempt": "",
"isSiteVacant": "",
"ListingPrice": "",
"OpeningBid": "",
"OriginalSaleDate": "",
"Pool": "Yes",
"PostReason": "",
"PreviousSaleDate": "",
"SaleAmount": "",
"SaleDate": "",
"SalePlace": "",
"SaleTime": "",
"Stories": "",
"Subdivision": "",
"TotalLoanBalance": "",
"WinningBid": "",
"Attorney": "SCHOLEFIELD PC",
"CaseNumber": "RG12344321",
"LisPendensType": "Mortgage Foreclosure",
"Longitude": "-121.879465",
"Latitude": "37.796045",
"TriggerType": "New Record",
"NewRecordType": "New Cashout Loan",
"NewRecordAttribute": 240000,
"Change1": "",
"Change2": "",
"Change3": ""
}

Did this answer your question?