Account Webhooks

Get real-time account and portal submission events.

Introduction

With Webhooks we POST a JSON message to a URL you specify whenever specific events take place within a branch account.

If you have multiple branches you can apply the same URL to receive updates on each.

HTTP status codes

When we try to send POST data to your callback URL, the returned HTTP status code will be checked. If your callback URL doesn't respond with either a 200, 301, 302 status code or the URL timed out, our system will try again 2 more times before cancelling. Each repeat attempt to send the POST data to your callback URL will be in 30 minute intervals.

portal_submission

This event is fired when a property is manually or automatically submitted to a real-time portal account with either a success or error response.

Example POST

{ "eaf_type": "portal_submission", "eaf_status": "success", "eaf_action": "update", "eaf_target": "rightmove", "eaf_id": "99426189915163065768167003", "eaf_date": "2021-09-03T22:06:38+01:00", "eaf_timestamp": 1630703198, "eaf_reference": "12345678", "eaf_portal_reference": "12345678_EAF_67003", "eaf_remote_url": "https:\/\/www.rightmove.co.uk\/" }

Standard parameters

eaf_type: [string] - the type of webhook that the data relates. eaf_status: [string] [success, error] - whether the submission was successfull or returned an error. eaf_action: [string] [create, update, delete] - the type of action that was requested. eaf_target: [string] [rightmove, zoopla, onthemarket] - the property portal the submission was sent. eaf_id: [string] - our unique ID for this submission. eaf_date: [datetime] - the date and time of the portal submission. eaf_timestamp: [number] - the date and time of the portal submission in unix timestamp format. eaf_reference: [string] - the original reference number for the property record. eaf_portal_reference: [string] - the reference number for the property record that was sent to and recorded by the portal. eaf_remote_url: [string] - the returned URL for the property record on the portal. Only present if eaf_action equals create or update.

Example POST

{ "eaf_type": "portal_submission", "eaf_status": "error", "eaf_action": "create", "eaf_target": "rightmove", "eaf_id": "99426189915163065768167004", "eaf_date": "2021-09-03T22:07:28+01:00", "eaf_timestamp": 1630703248, "eaf_portal_reference": "87654321_EAF_67004", "eaf_errors": [ { "eaf_code": "ERR_ACCOUNT_ALLOWANCE", "eaf_message": "Unable to add the listing as you've reached your visible or invisible account allowance." } ] }

Error parameters

If the eaf_status equals error, the following values are provided.

eaf_errors: [array] - contains one or more error blocks. eaf_code: [string] - our fixed error code for the type of error received. eaf_message: [string] - our description of the error received from the portal.

For a complete list of our error codes, please contact account support.

feed_import

This event is fired when a property datafeed is successfully imported into your account and included 1 or more records being created, updated or deleted.

Example POST

{ "eaf_type": "feed_import", "eaf_format": "xml_eaf_spec", "eaf_id": "55332867012531630906086", "eaf_agent_id": "29912188", "eaf_agent_name": "Estate Agent Feeds", "eaf_agent_email": "support@estateagentfeeds.com", "eaf_records_modified": 2, "eaf_source": "https:\/\/estateagentfeeds.com\/docs\/eaf_xml_import_sample.xml", "eaf_date": "2021-09-06T06:28:06+01:00", "eaf_timestamp": 1630906086 }

Standard parameters

eaf_type: [string] - the type of webhook that the data relates. eaf_format: [string] [blm, xml_eaf_spec, xml_kyero, xml_vebra, xml_jupix] - the datafeed internal identifier. This list is not exhaustive. eaf_id: [string] - our unique ID for this submission. eaf_agent_id: [string] - the unique agent or sub manager ID. eaf_agent_name: [string] - the name of the agent or sub manager that the import relates. eaf_agent_email: [string] - the email address of the agent or sub manager. eaf_records_modified: [number] - the total number or records that were created, updated and or deleted during the import. eaf_source: [string] - the URL, source type, or filename of the datafeed used during the import. eaf_date: [datetime] - the date and time of the import. eaf_timestamp: [number] - the date and time of the import in unix timestamp format.

email_lead

This event is fired when a portal email lead is imported into your account from one of the supported websites.

Example POST

{ "eaf_type": "email_lead", "eaf_id": "77722226661727188822717", "id": "01922rat12i23ug145162j27817220918", "email_source": "rightmove", "email_date_time": "2021-09-06 06:28:06", "contact_name": "EAF Support", "contact_email": "support@estateagentfeeds.com", "contact_phone": "+44(0)20 3870 4550", "contact_message_html": "This is an enquiry message.", "contact_message_flat": "This is an enquiry message.", "eaf_reference": "87654321", "eaf_portal_reference": "87654321_EAF_67004", "eaf_development_reference": null, "eaf_date": "2021-09-06T06:28:06+01:00", "eaf_timestamp": 1630906086 }

Standard parameters

eaf_type: [string] - the type of webhook that the data relates. eaf_id: [string] - our unique ID for this submission. id: [string] - the unique ID for the record. email_source: [string] - the source of the lead. email_date_time: [datetime] - the origin date of the lead enquiry. contact_name: [string] - the name of the contact who made the enquiry. contact_email: [string] - the email address of the contact who made the enquiry. contact_phone: [string] - the phone number of the contact who made the enquiry. contact_message_html: [string] - the message left by the contact who made the enquiry with line-breaks. contact_message_flat: [string] - the message left by the contact who made the enquiry without line-breaks. eaf_reference: [string] - the agency reference for the property the enquiry relates. eaf_portal_reference: [string] - the reference we sent to the portal for the property the enquiry relates. eaf_development_reference: [string] - the reference for the development the enquiry relates. eaf_date: [datetime] - the date and time of the lead enquiry being created. eaf_timestamp: [number] - the date and time of the lead being created in unix timestamp format.

Help and support

Please email support@estateagentfeeds.com if you require help with our Webhooks.

Ok message

Error message