MoxiWorks Realtime Stream

Welcome

Welcome to the MoxiCloud Realtime Stream documentation. MoxiWorks Platform Realtime Stream Updates give you instant updates of MoxiCloud data. Once you have set up your integration, you will receive updates instantly as they are made in the MoxiCloud, giving you the ability to better serve your customers.

In this section of the MoxiCloud Docs you’ll find documentation about integrating with the MoxiWorks Realtime Update (PubSub) notifications.

Getting Started

Why choose MoxiWorks Platform Realtime Stream updates?

The following are reasons you might want to utilize MoxiWorks Realtime Stream updates:

1) Instant Updates you get the data in your system as soon as a new listing/contact gets processed by our system. you have first access to new leads, new listings and new data because you’re not waiting for system synchronization – it’s always synchronized. This opens up a whole new range of product possibilities, giving you the ability to enhance your own product offerings and provide even better service to your clients.

2) Reduce Costs Instead of bogging down systems while synchronizing data for thousands of records at once, your updates are inherently distributed, ensuring that your systems are always responsive and ready to meet your primary business needs.

3) More Control By piping your SNS feed to SQS or to your own internal queueing mechanism allows you the ability to process incoming changes at whatever rate you want. You and your systems control how much data you import at any given time and ensure that rate never causes resource contention issues.

This documentation is intended to help you get you set up your MoxiWorks Platform Realtime Update Stream.

Getting Help

During your integration process with MoxiCloud Realtime Stream, your MoxiWorks Platform representative will work with you on getting your Realtime Stream Updates working. If you have any questions about getting set up, please contact your Platform Representative.

Setting Up For Updates

Setup Using An AWS SNS Topic

The MoxiWorks Platform Realtime Stream currently offers updates using Amazon’s Simple Notification Service (SNS). If you are interested in receiving MoxiWorks Realtime Stream Updates using a different method, please talk to your MoxiWorks Platform Representative.

SNS: Configuring For MoxiWorks Platform Realtime Stream Updates

In this section getting your Realtime Stream set up using SNS is covered. Use this to get your incoming MoxiWorks Realtime Stream Updates started. Once you’ve set up your SNS feed to receive updates from the MoxiWorks Realtime Stream you can then configure handling of those messages to best serve your needs. You might configure MoxiWorks Realtime Stream Updates to be sent to your servers or to go to an SQS queue – ensuring you never miss an update. Combining MoxiWorks Realtime Stream Updates with Amazon SNS gives you the flexibility to handle incoming data any way that you need.

Creating an SNS Topic for Realtime Stream Updates

Overview

To receive MoxiWorks Platform Realtime Stream Updates via SNS, first you’ll need to create an SNS topic in your AWS Console and give permissions to MoxiWorks to publish to that SNS topic. This section goes over setting up your SNS Topic. Later, we’ll go into getting data from your SNS Topic to your server.

Production MoxiWorks AWS User: arn:aws:iam::619293852110:user/pubsub-pr

QA MoxiWorks AWS User: arn:aws:iam::619293852110:user/pubsub-qa

Quickstart

If you’re familiar with setting up an SNS topic and giving permissions to a specific user for publishing to that topic, all you’ll need to do is:

1) Give publishing permissions for your topic to the MoxiWorks Platform Stream User in AWS. The platform stream user ID is shown to the right for QA and production environments.

2) Set up a subscription to receive incoming messages from that topic (HTTPS endpoint, SQS, etc.)

3) Let your MoxiWorks Platform Partner Services Representative know what the SNS topic ARN is and whether the topic is for QA or production updates.

SNS Configuration Procedure

If you need a little more help getting the SNS topic and subscription set up, we’ve created an instructional procedure that you can follow.

To set up MoxiWorks Platform Realtime Stream SNS Topic using the AWS SNS Console use the following procedure.

1) From your web browser, go to the Amazon SNS console at console.aws.amazon.com, to open the Amazon SNS Topics dashboard.

2) On the Amazon SNS Topics dashboard, click the Create topic button.

3) From the Details section of the Create topic interface, set the name of the topic. We recommend you utilize something that makes it clear that this is your MoxiWorks Platform Realtime Stream.

4) Click on the disclosure triangle to open the Access Policy section of the Create topic interface.

5) Ensure Basic method is selected.

6) Under the Define who can publish messages to the topic section, click the Only the specified AWS accounts radio button.

MoxiWorks Platform Realtime Stream AWS Account ID: 619293852110

7) In the text area that appears, paste the MoxiWorks Platform Realtime Stream AWS Account ID: 619293852110

8) Click the Create topic button to set up the topic.

9) In the details view for the SNS topic we just created in steps 1-8, click the Edit button.

10) Click on the disclosure triangle to open the Access Policy section of the Create topic interface.

11) Locate the line that gives permission to arn:aws:iam::619293852110:root

12) Change !arn:aws:iam::619293852110:root to arn:aws:iam::619293852110:user/pubsub-pr

13) Click the Save changes button

14) Let your MoxiWorks Platform Partner Services Representative know what the SNS topic ARN is and whether it is for QA or production updates.

Once you’ve completed this procedure, your Topic should now be ready to receive MoxiWorks Platform Realtime Stream Updates.

SNS: Receiving Updates

In this section, we’ll look at getting MoxiWorks Platform Realitime Stream Updates to your server; however, this is only one way that you might get data from SNS to your systems. You can investigate all the ways that you can integrate an SNS feed into your systems architecture via AWS help.

Configuring an SNS Topic To Send Updates To An Endpoint via HTTP or HTTPS

Overview

To receive MoxiWorks Platform Realtime Stream Updates from SNS, you’ll need to configure your SNS topic in your AWS Console to forward requests to your server. This section goes over setting up your SNS Topic to pass messages directly to your SNS enabled endpoint.

Quickstart

If you’re familiar with setting up SNS endpoints for data consumption, then all you’ll need to do is: 1) Set up your SNS endpoint on your server.

2) Configure your SNS Topic to point to your server.

SNS Configuration Procedure

If you need help in configuring your SNS Topic to deliver messages to your SNS enabled endpoint, we’ve created this instructional procedure to help you.

To set up your endpoint to receive MoxiWorks Platform Realtime Stream Updates via your SNS Topic, use the following procedure.

1) From your web browser, go to the Amazon SNS console at console.aws.amazon.com, to open the Amazon SNS Topics dashboard.

2) On the Amazon SNS Topics dashboard, click the SNS topic that is set up to receive messages.

3) From the SNS Topic’s details page, click the Create subscription button.

This will open the Create subscription interface.

4) From the Details section, click the Protocol dropdown menu.

5) Select the appropriate protocol for your incoming SNS messages.

6) If using HTTP or HTTPS as your protocol, set the URL of the endpoint which you expect to receive messages.

7) Click the Create subscription button to create the subscription.

Update Handling

The MoxiWorks Platform Realtime Stream is designed to allow you to use the same parsing logic for both Realtime Stream Updates as well as MoxiCloud API calls. Except where noted below, data pushed via Realtime Updates should have have almost exactly shape as objects pulled via MoxiCloud API. Exceptions are noted in the Data Shape sections below.

Payload Metadata

Each message sent to your system by the MoxiWorks Platform Realtime Stream will have metadata associated with the object payload in the root level of the payload. In this section we’ll take a look at the metadata provided in the root level of the response.

Realtime Stream Update Payload Metadata Example

{ 
    "timestamp": 1563912491,
    "type":"/[agent|contact|listing|office]/",
    "action":"/[create|update|upsert|delete]/",
    "data":{
        ...
    }
}

Realtime Stream Update Payload Metadata

As previously noted, the payload of the data sent will (as close as possible) match the MoxiCloud API object shape. For example, each Agent object will match the shape of the Agent that is provided via the MoxiCloud; however, the payload itself is wrapped in an outer scope that provides metadata about the update that would normally be implicitly scoped in a request to the MoxiCloud API. In orderto ensure that incoming updates are routed to the correct parsing logic, you’ll need to inspect the metadata in the payload to determine the kind of update being sent and then route it to the correct logic for parsing and processing.

Attribute	Type	Notes
timestamp	Integer	Unix timestamp in full seconds
type	String	Enumerated set includes agent, contact, listing, office
action	String	Enumerated set includes create, update, upsert, delete
data	Object	Update Payload

timestamp This is the Unix timestamp representing the date/time that this Realtime Stream Update was generated. You can utilize the timestamp to ensure that no out-of-order updates occur.

type The type of entity update is in the payload of the message. this will be one of agent, contact, listing or office.

action The action associated with the update. this will be one of create, update, upsert or delete.

data A JSON object representing the entity in the MoxiCloud.

Update Types

The MoxiWorks Platform Realtime Stream provides updates to Agent, Contact, Listing and Office data.

Agent

Agent Update Data

The following attributes make up the payload of the Agent type for a MoxiWorks Platform Realtime Agent Update.

Agent Realtime Update Payload Example

{
"agent_info": {
    "uuid": "8675309e9-1234-dead-beef-deadbeefdead",
    "short_id": "abc123",
    "email_address": "agentemail@agent.email"
},
"client_agent_id":"abc123",
  "mls_agent_id":"MLS_ID",
  "license":"abc123lic",
  "mls_name":"Bob's Better MLS",
  "mls_abbreviation":"BBM",
  "moxi_works_office_id":"8c3f446c-aab9-11e6-9a0f-d0e1408e8026",
  "office_id":"1234",
  "client_office_id":"987123",
  "company_id":"2345",
  "client_company_id":"abc392",
  "agent_id":"67890",
  "office_address_street": "3456 Office Ln.",
  "office_address_street2":"Suite 1234",
  "office_address_city": "Officeville",
  "office_address_state": "AG",
  "office_address_zip": "12345",
  "name": "Buckminster Fuller",
  "first_name": "Buckminster",
  "last_name": "Fuller",
  "main_phone_number": "555) 9101112",
  "mobile_phone_number": "555 333 4567",
  "alt_phone_number": "(555) 567-8910",
  "fax_phone_number": "5557891011",
  "office_phone_number": "(234)456-7890",
  "primary_email_address": "the_agent@agentdomain.com",
  "secondary_email_address": "the_agent_alt@otherdomain.com",
  "email_addresses": {
    "primary": "primary@email.com",
    "display": "display@email.com",
    "alternate": null,
    "moxi_sync": "moxi@email.com",
    "lead_routing": "lead@email.com",
    "zillow": null
  },
  "lead_routing_email_address":"leadrouter@thisdomain.com",
  "title": "Broker",
  "uuid":"8675309e9-1234-dead-beef-deadbeefdead",
  "has_engage_access":true,
  "website_base_url": "mymoxi@website.com",
  "twitter": "https://twitter.com/agentguy",
  "google_plus": "https://plus.google.com/1234567891011121314/posts",
  "facebook": "https://www.facebook.com/moxiworks/",
  "home_page": "foo.com",
  "profile_image_url": "http://picturererer.com/pics37/ImageStore.dll?id=852087C5D3A533DD&w=200",
  "profile_thumb_url": "http://picturererer.com/pics37/ImageStore.dll?id=852087C5D3A533DD&w=75",
  "service_area_zip_codes": [
    "98117",
    "98105"
  ],
  "company_programs": [
    "Deluxe Listings agent",
    "Very Cool Program Manager"
  ],
  "alternate_offices": [
  {
    "moxi_works_office_id": "abc123",
    "office_id": 1234,
    "office_address_street": "2636 NW Office Street",
    "office_address_street2": null,
    "office_address_city": "Altville",
    "office_address_state": "IN",
    "office_address_zip": "23232",
    "office_phone_number": "813.555.1221"
    },
      {
    "moxi_works_office_id": "xyz789",
    "office_id": 5678,
    "office_address_street": "700 123rd Ave",
    "office_address_street2": "Suite 1234",
    "office_address_city": "Nextus",
    "office_address_state": "AL",
    "office_address_zip": "99899",
    "office_phone_number": "66655544444"
    }
  ]
}

Agent Attributes

Attribute	Type
agent_info	Object
client_agent_id	String
mls_agent_id	String or null
license	String or null
mls_name	String or null
mls_abbreviation	String or null
agent_id	String
moxi_works_office_id	String
office_id	String
client_office_id	String
company_id	String
client_company_id	String
office_address_street	String or null
office_address_street2	String or null
office_address_city	String or null
office_address_state	String or null
office_address_zip	String or null
name	String or null
first_name	String or null
last_name	String or null
nickname	String or null
main_phone_number	String or null
mobile_phone_number	String or null
alt_phone_number	String or null
fax_phone_number	String or null
office_phone_number	String or null
primary_email_address	String or null
secondary_email_address	String or null
email_addresses	Hash
lead_routing_email_address	String or null
title	String or null
uuid	String
has_product_access	Boolean
has_engage_access	Boolean
access_level	String
website_base_url	String or null
twitter	String or null
google_plus	String or null
facebook	String or null
home_page	String or null
profile_image_url	String
profile_thumb_url	String
region	String or null
gci_goal	Integer
buyer_commission_rate	Float
seller_commission_rate	Float
service_area_zip_codes	Array
alternate_offices	Array
available_mls	Array
partners	Array
company_programs	Array
created_timestamp	Integer
deactivated_timestamp	Integer or null

Attribute	Type

client_agent_id This is the ID of the Agent utilized by their company.

mls_agent_id This is the ID of the Agent utilized by their primary MLS.

license This is the number of the license granted to the agent.

mls_name This is the name of the primary MLS for the agent.

mls_abbreviation This is the standard abbreviation of the primary MLS utilized by the agent.

agent_id This is the ID of this Agent. This will be an integer.

moxi_works_office_id This is the MoxiWorks Platform ID of the office for this Agent. This will be an RFC 4122 compliant UUID.

office_id This is the ID of the office for this Agent. This will be an integer.

client_office_id This is the ID of the office for this Agent utilized by their company.

company_id This is the ID of the company for this Agent. This will be an integer.

client_company_id This is the ID of the Company utilized by their company.

office_address_street The street address of the agent’s office. This can be null if there is no data for this attribute.

office_address_street2 The suite or office number of the agent’s office. This can be null if there is no data for this attribute.

office_address_city The city the agent’s office is in. This can be null if there is no data for this attribute.

office_address_state The state or provice the agent’s office is in. This can be null if there is no data for this attribute.

office_address_zip The postal code the agent’s office is in. This can be null if there is no data for this attribute.

name The full name of the agent. This can be null if there is no data for this attribute.

first_name The first name of the agent. This can be null if there is no data for this attribute.

last_name The last name of the agent. This can be null if there is no data for this attribute.

nickname The nickname of the agent. This can be null if there is no data for this attribute.

mobile_phone_number Mobile phone number of the agent. main_phone_number should be considered higher priority, if not the same. This can be null if there is no data for this attribute.

alt_phone_number Alternate phone number for the agent. This should be considered second in priority to main_phone_number. This can be null if there is no data for this attribute.

fax_phone_number This is the agent’s fax phone number. This can be null if there is no data for this attribute.

main_phone_number This is the agent’s main phone number. This number should be considered the number the agent would like to be contacted by. This can be null if there is no data for this attribute.

fax_phone_number This is the agent’s fax phone number. This can be null if there is no data for this attribute.

office_phone_number This is the agent’s office phone number. This can be null if there is no data for this attribute.

primary_email_address This is the agent’s main email address. This email address should be considered the email address the agent would prefer to be contacted by. This can be null if there is no data for this attribute.

secondary_email_address This is the agent’s alternate email address. This email address should be considered the email address the agent would want to be contacted by only if the address in primary_email_address is not functional. This can be null if there is no data for this attribute.

lead_routing_email_address This is the agent’s lead routing email address. This can be null if there is no data for this attribute.

title This is the business title of the agent. This can be null if there is no data for this attribute.

has_product_access Indicates whether the agent has access to MoxiWorks Products.

has_engage_access Indicates whether the agent has access to MoxiWorks Engage.

access_level The access level of the agent.

website_base_url The base url of the agent’s MoxiWorks agent website.

twitter Agent’s Twitter URL. This can be null if there is no data available for this attribute.

google_plus Agent’s Google Plus URL. This can be null if there is no data for this attribute.

facebook Agent’s Facebook page url. This can be null if there is no data for this attribute.

home_page Agent’s website domain. This will be returned without the HTTP(S) prefix. You’ll need to prefix the domain with protocol if using this attribute for an href. This can be null if there is no data for this attribute.

profile_image_url This is a valid URL for a larger size image for the agent. If no agent image has been uploaded for this agent a default image url will be provided.

profile_thumb_url This is a valid URL for a thumbnail size image for the agent. If no agent image has been uploaded for this agent a default image url will be provided.

region The region the agent’s office is in. This can be null if there is no data for this attribute.

gci_goal The agent’s stated gross commission income goal.

buyer_commission_rate Percentage commission rate for the agent when acting as a buyer’s agent.

seller_commission_rate Percentage commission rate for the agent when acting as a seller’s agent.

service_area_zip_codes A list of the lead service area zip codes covered by the agent.

company_programs A list of the company specific program names in which the agent participates or is a member.

created_timestamp This is the Unix timestamp representing the date that this Agent was created in the MoxiWorks system.

deactivated_timestamp This is the Unix timestamp representing the date that this Agent was deactivated in the MoxiWorks system. This will be returned null if the agent is still active.

agent_info Object

The agent_info object contains the IDs that may be used for Agent associations in the MoxiWorks platform based on your use-case.

|uuid|String| |short_id|Integer| |email_address|String|

uuid This is an RFC 4122 compliant UUID associated with the agent.

short_id This will be a four or five character unique alphanumeric identification string.

email_address This is the email address of the agent.

alternate_offices Object

The alternate_offices array contains Dictionary objects representing AlternateOffice entries. The structure of each AlternateOffice entry is shown below.

Attribute	Type
moxi_works_office_id	String
office_id	Integer
office_address_street	String
office_address_street2	String
office_address_city	String
office_address_state	String
office_address_zip	String
office_phone_number	String

moxi_works_office_id This is the unique identifier for the MoxiWorks Platform AlternateOffice entry.

office_id This is an integer identifier for the MoxiWorks Platform AlternateOffice entry. If you are using MoxiWorks SSO, this will be the ID corresponding to the ID provided there.

office_address_street The street address of the office represented by this AlternateOffice entry.

office_address_street2 The second line of the street address (if required) of the office represented by this AlternateOffice entry.

office_address_city The city portion of the address of the office represented by this AlternateOffice entry.

office_address_state The state portion of the address of the office represented by this AlternateOffice entry.

office_address_zip The postal code portion of the address of the office represented by this AlternateOffice entry.

office_phone_number The phone number of the office represented by this AlternateOffice entry.

available_mls Object

The available_mls Array contains Dictionary objects representing MLS entries. The structure of each MLS entry is shown below.

Attribute	Type
name	String
display_name	String
mls_abbreviation	String
agent_id	String

name The MoxiWorks internal unique name for the MLS.

display_name The name of the MLS as it is to be displayed to users.

mls_abbreviation The abbreviation of the MLS.

agent_id The agent’s MLS id.

partners Objects

Exstence of objects in the partners data structure is dependent upon external relationships existing between the agent represented by this Agent and the affiliate.

leading_re partner Objects

Attribute	Type
salesforce_id	String or null
luxury_portfolio	Boolean

salesforce_id This is the unique salesforce ID of the company in the LeadingRE system.

luxury_portfolio Indicates whether or not this agent has luxury portfolio association in the LeadingRE system.

email_addresses Object

The email_addresses Hash is a Dictionary object holding the email addresses associated with the Agent record. The structure of the object is shown below.

Attribute	Type
primary	String or null
display	String or null
alternate	String or null
moxi_sync	String or null
lead_routing	String or null
zillow	String or null

primary The primary email address associated with the Agent record.

display The display email address associated with the Agent record.

alternate The alternate email address associated with the Agent record.

moxi_sync The moxi_sync email address associated with the Agent record.

lead_routing The lead_routing email address associated with the Agent record.

zillow The zillow email address associated with the Agent record.

Differences From API Response

The payload of the Agent update matches the response provided via the MoxiWorks Platform API with the following exceptions:

Attributes Removed

Attribute	Use Instead
moxi_works_agent_id	use attribute in the agent_info object matching the ID you use in your system to determine the Agent’s ID.
mls_name	use the available_mls array to determine the MLSs the agent is a member of.
mls_abbreviation	use the available_mls array to determine the MLSs the agent is a member of.

Attributes Added

Attribute	Type
agent_info	Object

agent_info Payload Example

"agent_info":{
    "uuid":"8675309e9-1234-dead-beef-deadbeefdead",
    "short_id":"abc123",
    "email_address":"agentemail@agent.email"
}

agent_info Object

The agent_info object contains the IDs that may be used for Agent associations in the MoxiWorks platform based on your use-case.

Attribute	Type
uuid	String
short_id	Integer
email_address	String

The agent_info object contains the various IDs that can be utilized to identify an agent via the moxi_works_agent_id attribute when sending requests to the MoxiWorks Platform API. Determine which Agent ID your system uses to identify Agents in the MoxiWorks Platform API and map your logic to the appropriate ID contained in the agent_info object.

Contact

Contact Update Data

The following attributes make up the payload of the Contact type for a MoxiWorks Platform Realtime Contact Update.

Contact Realtime Update Payload Example

{
"agent_info": {
    "uuid": "8675309e9-1234-dead-beef-deadbeefdead",
    "short_id": "abc123",
    "email_address": "agentemail@agent.email"
},
 "partner_contact_id": "booyuh",
  "moxi_works_contact_id":"deadbeef-feed-face-bad4dad22dead",
  "moxi_works_lead_source_id": "some_lead_source_id",
  "moxi_works_origin_lead_source_id": "some_other_lead_source_id",
  "is_deleted": false,
  "contact_name":"Firstname Middlenyme Larstnam",
  "first_name":"Firstname",
  "middle_name":"Middlenyme",
  "last_name":"Larstnam",
  "suffix":null,
  "gender": "m",
  "label_name": "Mr. and Mrs. Oo-De-Lally Golly What a Day",
  "primary_email_address":"primary@email.com",
  "secondary_email_address":"secondary@email.com",
  "primary_phone_number":"3603603608",
  "secondary_phone_number":"3603603609",
  "email_addresses": [
    {
      "key": "email_address1",
      "address": "primary@email.com"
    },
    {
      "key": "email_address2",
      "address": "secondary@email.com"
    },
    {
      "key": "email_address3",
      "address": "also@this.com"
    }
  ],
  "phone_numbers": [
    {
      "key": "mobile_phone",
      "number": "3603603608"
    },
    {
      "key": "home_phone",
      "number": "3603603609"
    },
    {
      "key": "business_phone",
      "number": "3603603610"
    },
  ],
  "home_street_address": "1234 Sesame St.",
  "home_city": "Cityville",
  "home_state": "Stateland",
  "home_zip": "12345-6789",
  "home_country": "Ottoman Empire",
  "job_title": "Junior Bacon Burner",
  "occupation": "chef",
  "is_new_contact": true,
  "birthday": 1496310636,
  "anniversary": 1495199540,
  "home_purchase_anniversary": 1484088442,
  "social_media_profiles": [
    {
  "key": "facebook",
  "url": null
  },
    {
  "key": "linkedin",
  "url": null
  },
    {
  "key": "twitter",
  "url": null
  },
    {
  "key": "googleplus",
  "url": null
  }
  ],
  "groups":[
    "this group",
    "that group",
    "the other group"
  ],
  "property_url": "http://my.property.website.is/here",
  "property_mls_id": "abc123",
  "property_street_address": "2345 67th place",
  "property_city": "Townland",
  "property_state": "Statesville",
  "property_zip": "98765-4321",
  "property_beds": "18",
  "property_baths": "12.5",
  "property_list_price": "123456789",
  "property_listing_status": "Active",
  "property_photo_url": "http://property.photo.is/here.jpg",
  "search_city": "Searchland",
  "search_state": "Searchsylvania",
  "search_zip": "12345-6789",
  "search_min_beds": "2",
  "search_min_baths": "3.25",
  "search_min_price": "1234567",
  "search_max_price": "1234569",
  "search_min_sq_ft": "1234",
  "search_max_sq_ft": "1235",
  "search_min_lot_size": "3234",
  "search_max_lot_size": "3235",
  "search_min_year_built": "1388",
  "search_max_year_built": "2044",
  "search_property_types": "Condo, Single Family, Townhouse",
  "websites": [
      {
        "rank": 1,
        "key": "website_key_1",
        "value": "https://blep.com"
      },
      {
        "rank": 2,
        "key": "website_key_2",
        "value": "https://blep.com"
      }
    ],
  "home_purchase_anniversaries": [
      1484088442
   ],
  "company": "Blep Ltd.",
  "spouse_or_partner": "Rick Sanchez"
}

Contact Attributes

Attribute	Type
agent_info	Object
moxi_works_agent_id*	String
partner_contact_id	String
moxi_works_contact_id	String
moxi_works_lead_source_id	String
moxi_works_origin_lead_source_id	String
is_deleted	Boolean
contact_name	String or null
first_name	String or null
middle_name	String or null
last_name	String or null
suffix	String or null
gender	String or null
label_name	String or null
primary_email_address	String or null
secondary_email_address	String or null
email_addresses	Array
primary_phone_number	String or null
secondary_phone_number	String or null
phone_numbers	Array
home_street_address	String or null
home_city	String or null
home_state	String or null
home_zip	String or null
home_country	String or null
job_title	String or null
occupation	String or null
company	String or null
websites	Array
spouse_or_partner	String or null
is_new_contact	Boolean
birthday	Integer or null
anniversary	Integer or null
home_purchase_anniversary	Integer or null
social_media_profiles	Array
groups	Array
property_url	String or null
property_mls_id	String or null
property_street_address	String or null
property_city	String or null
property_state	String or null
property_zip	String or null
property_beds	String or null
property_baths	String or null
property_list_price	String or null
property_listing_status	String or null
property_photo_url	String or null
search_city	String or null
search_state	String or null
search_zip	String or null
search_min_baths	String or null
search_min_beds	String or null
search_min_price	String or null
search_max_price	String or null
search_min_sq_ft	String or null
search_max_sq_ft	String or null
search_min_lot_size	String or null
search_max_lot_size	String or null
search_min_year_built	String or null
search_max_year_built	String or null
search_property_types	String or null
note	String or null
websites	Array
home_purchase_anniversaries	Array
company	String or null
spouse_or_partner	String or null
category_names	String or null
groups	Array

* Either agent_uuid or moxi_works_agent_id will be returned depending on whether it is used in the request. The response payload object’s agent identifier key will match the passed parameter.

agent_uuid This is the MoxiWorks Platform ID of the Agent which this Contact is associated with. This will be an RFC 4122 compliant UUID.

moxi_works_agent_id This is the MoxiWorks Platform ID of the Agent. This will be a string that may take the form of an email address, or a unique alphanumeric identification string.

partner_contact_id This is the unique identifer you use in your system that has been associated with the Contact that you are finding.

moxi_works_contact_id This is the MoxiWorks Platform ID of this Contact. This will be an RFC 4122 compliant UUID.

moxi_works_lead_source_id This is the unique MoxiWorks Platform ID of the LeadSource that generated this Contact.

moxi_works_origin_lead_source_id This is used to keep track of the original lead source for this Contact record. This field will not be displayed in MoxiEngage, and is for the parter’s own tracking purposes. This key will be associated with valid moxi_works_lead_source_id. Send a LeadSource index request for a full list of applicable lead sources and their ids.

is_deleted Will be true if this Contact has been deleted from the Agents contacts.

contact_name This is the full name of the contact you are finding a Contact record for. You should format this information as first middle last. This value will be null if no data is available for this attribute.

first_name This is the first name of the contact associated with this Contact record. This value will be null if no data is available for this attribute.

middle_name This is the middle name of the contact associated with this Contact record. This value will be null if no data is available for this attribute.

last_name This is the last name of the contact associated with this Contact record. This value will be null if no data is available for this attribute.

suffix This is the generational suffix of the name of the contact associated with this Contact record. This value will be null if no data is available for this attribute. Supported suffixes are II III IV JR JR..

gender The gender of the contact. This can be male, female, m or f. No matter what is provided in the request, the response payload will return m or f. This value will be null if no data is available for this attribute.

label_name This is the name used to address the contact when creating mailing labels for the contact associated with this Contact record. This value will be null if no data is available for this attribute.

primary_email_address This is the email address that should be used first. If provided, the address must conform to RFC 3696. This value will be null if no data is available for this attribute. This attribute should not be used in conjunction with the email_addresses attribute.

secondary_email_address This is the email address that should be used as an alternate. If provided, the address must conform to RFC 3696. This value will be null if no data is available for this attribute. This attribute should not be used in conjunction with the email_addresses attribute.

agent_info Object

The agent_info object contains the IDs that may be used for Agent associations in the MoxiWorks platform based on your use-case.

|uuid|String| |short_id|Integer| |email_address|String|

uuid This is an RFC 4122 compliant UUID associated with the agent for this contact.

short_id This will be a four or five character unique alphanumeric identification string.

email_address This is the email address of the agent for this contact.

email_addresses Objects

These email addresses correspond to agent created Contact entities. Only phone fields present in this Contact record will be returned.

Each object in the email_addresses array will have the following structure:

Attribute	Type
key	String
address	String

key The key identifier of the email field. The appropriate email keys are determined by the email server type associated with the Agent. The key identifiers for Agent entities synced to MoxiEngage via a Microsoft Exchange account are: email_address1, email_address2, email_address3. The key identifiers for Agent entities synced to MoxiEngage via a Google account are: home, work, other.

address The email address field value.

primary_phone_number This is the phone number that should be used first. It should be a 10 digit phone number. This attribute should not be used in conjunction with the phone_numbers attribute.

secondary_phone_number This is the phone number that should be used as an alternate. It should be a 10 digit phone number. This attribute should not be used in conjunction with the phone_numbers attribute.

phone_numbers Objects

These phone numbers correspond to agent created Contact entities. Only phone fields present in this Contact record will be returned.

Each object in the phone_numbers array will have the following structure:

Attribute	Type
key	String
number	String

key The key identifier of the phone field. The appropriate phone keys are determined by the email server type associated with the Agent. The key identifiers for Agent entities synced to MoxiEngage via a Microsoft Exchange account are: mobile_phone, home_phone, home_phone2, business_phone, business_phone2, assistant_phone, home_fax, business_fax, car_phone, company_main_phone, other_fax, other_telephone, callback, isdn, pager. The key identifiers for Agent entities synced to MoxiEngage via a Google account are: mobile, home, work, assistant, home_fax, tty_tdd, radio, main, work_fax, car, other, pager, isdn, callback, telex.

number The phone number field value.

home_street_address The contact’s home address street, including number and any suite / apartment number information. This value will be null if no data is available for this attribute.

home_city The city of the contact’s home address. This value will be null if no data is available for this attribute. This value will be null if no data is available for this attribute.

home_state The state of the contact’s home address. This value will be null if no data is available for this attribute.

home_zip The zip code of the contact’s home address. This value will be null if no data is available for this attribute.

home_country The country of the contact’s home address. This value will be null if no data is available for this attribute.

job_title The contact’s professional job title. This value will be null if no data is available for this attribute.

occupation The contact’s profession. This value will be null if no data is available for this attribute.

is_new_contact Whether the contact was recently added to the Agent’s database.

birthday Birthday of the contact represented as a Unix Timestamp.

anniversary Wedding anniversary of the contact represented as a Unix Timestamp.

home_purchase_anniversary Anniversary of the contact’s home purchase represented as a Unix Timestamp.

home_purchase_anniversaries A list of Unix Timestamps representing the contact’s home purchase anniversaries.

company The name of the company associated with the contact.

spouse_or_partner The spouse or partner of the contact.

category_names A comma separated list of the agent’s mail server groups / categories to which this contact belongs.

groups An array of the agent’s mail server groups / categories to which this contact belongs.

websites Objects

Each object in the websites array will have the following structure.

Attribute	Type
rank	Integer
key	String
value	String

rank The website’s priority in the contact record.

key The key identifier of the website for use in digesting websites added to the contact record via MoxiEngage

key The url of the website.

social_media_profiles Objects

Each object in the social_media_profiles array will have the following structure.

Attribute	Type
key	String
url	String

key The key identifier of the social media url. Defined keys are ‘facebook,’ ‘linkedin,’ ‘twitter,’ and 'googleplus’

groups Any Agent groups which the contact by name.

property_url This will be a valid URL for a property of interest in your system that can be viewed by the agent. This value will be null if no data is available for this attribute.

property_mls_id This will be the MLS ID of the property of interest. This value will be null if no data is available for this attribute.

property_street_address This will be the street address of the property of interest, including number and suite/apartment number information. This value will be null if no data is available for this attribute.

property_city This will be the city in which the property of interest exists. This value will be null if no data is available for this attribute.

property_state This will be the state or province in which the property of interest exists. This value will be null if no data is available for this attribute.

property_zip This will be the postal code in which the property of interest exists. This value will be null if no data is available for this attribute.

property_beds This will be the number of bedrooms in the property of interest. This value will be null if no data is available for this attribute.

property_baths This will be the number of bathrooms in the property of interest. This value will be null if no data is available for this attribute.

property_list_price This will be the list price of the property of interest. This value will be null if no data is available for this attribute.

property_listing_status This will be the listing status of the property of interest. This can be any arbitrary string, but for best results, this should be a state like Active, Pending, Sold, Cancelled or any other human readable state that would be useful when presented to the agent. This value will be null if no data is available for this attribute.

property_photo_url This will be a valid URL to an image of the property of interest. This value will be null if no data is available for this attribute.

search_city This will be the city / locale used in the listing search criteria. This value will be null if no data is available for this attribute.

search_state This will be the state / region used in the listing search criteria. This value will be null if no data is available for this attribute.

search_zip This will be the zip / postal code used in the listing search criteria. This value will be null if no data is available for this attribute.

search_min_baths This will be the minimum bathrooms used in the listing search criteria. This value will be null if no data is available for this attribute.

search_min beds This will be the minimum bedrooms used in the listing search criteria. This value will be null if no data is available for this attribute.

search_min_price This will be the minimum price used in the listing search criteria. This value will be null if no data is available for this attribute.

search_max_price This will be the maximum price used in the listing search criteria. This value will be null if no data is available for this attribute.

search_min_sq_ft This will be the minimum square feet of the total living area used in the listing search criteria. This value will be null if no data is available for this attribute.

search_max_sq_ft This will be the maximum square feet of the total living area used in the listing search criteria. This value will be null if no data is available for this attribute.

search_min_lot_size This will be the minimum lot size used in the listing search criteria. This value will be null if no data is available for this attribute.

search_max_lot_size This will be the maximum lot size used in the listing search criteria. This value will be null if no data is available for this attribute.

search_min_year_built This will be the minimum allowable year built used in the listing search criteria. This value will be null if no data is available for this attribute.

search_property_types This will be the property types used in the listing search criteria. This can be any arbitrary human readable string, but using recognized property types such as Condo, Single-Family, Townhouse, Land, Multifamily will provide more value to the agent. This value will be null if no data is available for this attribute.

note This is an arbitrary string giving the agent more details about the contact which would not otherwise fit into the Contact record. Any Notes added here will be displayed to the agent in an Activity Log record. Any HTML formatting included will be stripped from the note attribute’s data. This value will be null if no data is available for this attribute.

Differences From API Response

The payload of the Agent update matches the response provided via the MoxiWorks Platform API with the following exceptions:

Attributes Removed

Attribute	Use Instead
moxi_works_agent_id	use attribute in the agent_info object matching the ID you use in your system to determine the Agent’s ID.
agent_uuid	use attribute in the agent_info object matching the ID you use in your system to determine the Agent’s ID.

Attributes Added

Attribute	Type
agent_info	Object

agent_info Payload Example

"agent_info":{
    "uuid":"8675309e9-1234-dead-beef-deadbeefdead",
    "short_id":"abc123",
    "email_address":"agentemail@agent.email"
}

agent_info Object

The agent_info object contains the IDs that may be used for Agent associations in the MoxiWorks platform based on your use-case.

Attribute	Type
uuid	String
short_id	Integer
email_address	String

The agent_info object contains the various IDs that can be utilized to identify an agent via the moxi_works_agent_id attribute when sending requests to the MoxiWorks Platform API. Determine which Agent ID your system uses to identify Agents in the MoxiWorks Platform API and map your logic to the appropriate ID contained in the agent_info object.

Listing

Listing Update Data

The following attributes make up the payload of the Listing type for a MoxiWorks Platform Realtime Listing Update.

Listing Realtime Update Payload Example

{
  "LotSizeAcres":0.0,
  "BathroomsFull":3,
  "BathroomsHalf":0,
  "BathroomsOneQuarter":null,
  "BathroomsPartial":null,
  "BathroomsThreeQuarter":null,
  "BathroomsTotalInteger":3,
  "BathroomsTotal":3.0,
  "BedroomsTotal":8,
  "PublicTitle":"Amazingly Remarkable!",
  "PublicRemarks":"Publicalistically Remarkabalistically! REMARKABLE!!",
  "ModificationTimestamp":"2018-03-20T11:04:55.659-07:00",
  "InternetAddressDisplayYN":true,
  "DaysOnMarket":0,
  "ListingContractDate":"07/27/2016",
  "CreatedDate":"11/01/2016",
  "ElementarySchool":"Elementary My Dear School",
  "GarageSpaces":4,
  "WaterfrontYN":false,
  "HighSchool":"Higher Than Junior",
  "AssociationFee":null,
  "ListOfficeName":"Realty Valley United",
  "ListPrice":599000,
  "ListingID":"12323",
  "ListAgentFullName":"Bob Agentson",
  "ListAgentUUID":"8675309e9-1234-dead-beef-deadbeefdead",
  "ListAgentOfficeID":"abc123",
  "ListAgentMoxiWorksOfficeID":"abcd1234",
  "SecondaryListAgentFullName":"Richard Agent",
  "SecondaryListAgentUUID":"8675309e9-2345-dead-beef-deadbeefdead",
  "SchoolDistrict":"Hilltop District",
  "Address":"97 Hilltop Road",
  "Address2":null,
  "City":"Montecarlo",
  "CountyOrParish":"Counting Parishes",
  "Latitude":"47.723251",
  "Longitude":"-122.171745",
  "StateOrProvince":"NV",
  "PostalCode":"87654",
  "Community":"Shady Acres",
  "LotSizeSquareFeet":null,
  "InternetEntireListingDisplayYN":true,
  "MiddleOrJuniorSchool":"*The* Junior High" ,
  "ListOfficeAOR":"WHATEVERS MLS",
  "ListOfficeAORArea":"Area 51",
  "PoolYN":false,
  "PropertyType":"Residential",
  "TaxAnnualAmount":13652,
  "TaxYear":2015,
  "SingleStory":false,
  "LivingArea":3640,
  "ViewYN":false,
  "YearBuilt":1989,
  "OnMarket":true,
  "Status":"active",
  "MoxiWorksListingId":"abc123",
  "AgentCreatedListing":false,
  "VirtualTourURL":"http://the.virtual.tour.url",
  "SharedPartnerData":{
     "attribute_1": "value_1",
     "attribute_2": "value_2"
  },
  "ListingURL":"http://the.listing.url",
  "PropertyFeatures":[
    {
      "PropertyFeatureName": "Kitchen Information",
      "PropertyFeatureValues": [
        "Dishwasher",
        "Microwave",
        "Oven/Range Freestanding"
      ]
      },
      {
      "PropertyFeatureName": "Roof Description",
      "PropertyFeatureValues": [
        "Comp Shingle"
      ]
      },
      {
      "PropertyFeatureName": "Number Of Stories",
      "PropertyFeatureValues": [
        "Two Story"
      ]
      },
        {
      "PropertyFeatureName": "Interior Features",
      "PropertyFeatureValues": [
        "Bath Master",
        "Broadband Internet",
        "Cable/Satellite Tv",
        "Dishwasher",
        "Microwave",
        "Oven/Range Freestanding"
      ]
    }
  ],
  "CompanyListingAttributes": [
    {
      "AttributeId": "the collection",
      "AttributeName": "The Collection"
    },
      {
        "AttributeId": "destination",
        "AttributeName": "Destination"
    }
  ],
  "OpenHouse":[
    {
      "Date":"2018-01-06",
      "StartTime":"13:00:00",
      "EndTime":"15:00:00",
      "VirtualOpenHouseYN":false,
      "VirtualOpenHouseURL":null,
      "Comment":null
      }
  ],
  "ListingImages":[
    {
      "FullURL":"http://images.moxiworks.com/static/images/br/imagoo/default_property_image_wre-326x250.png",
      "GalleryURL":"http://images.moxiworks.com/static/images/br/imagoo/default_property_image_wre-326x250.png",
      "RawURL":"http://images.moxiworks.com/static/images/br/imagoo/default_property_image_wre-326x250.png",
      "SmallURL":"http://images.moxiworks.com/static/images/br/imagoo/default_property_image_wre-326x250.png",
      "ThumbURL":"http://images.moxiworks.com/static/images/br/imagoo/default_property_image_wre-326x250.png",
      "Title":"Image Title",
      "IsMainListingImage":true,
      "Caption":"Image Caption",
      "Description":"Image Description",
      "Width":1024,
      "Height":768,
      "MimeType":"image/jpeg"
      }
  ],
}

Listing Update Data

Attribute	Type
LotSizeAcres	Float or null
BathroomsFull	Integer or null
BathroomsHalf	Integer or null
BathroomsOneQuarter	Integer or null
BathroomsPartial	Integer or null
BathroomsThreeQuarter	Integer or Null
BathroomsTotalInteger	Integer or null
BathroomsTotal	Float or null
BedroomsTotal	Integer or null
PublicTitle	String or null
PublicRemarks	String or null
ModificationTimestamp	String
InternetAddressDisplayYN	Boolean or null
DaysOnMarket	Integer
ListingContractDate	String
CreatedDate	String
ElementarySchool	String or null
GarageSpaces	Integer or null
WaterfrontYN	Boolean or null
HighSchool	String or null
AssociationFee	Integer or null
ListOfficeName	String or null
ListPrice	Integer or null
ListingID	String
ListAgentFullName	String
ListAgentUUID	String
ListAgentOfficeID	String
ListAgentMoxiWorksOfficeID	String
SecondaryListAgentFullName	String or null
SecondaryListAgentUUID	String or null
SchoolDistrict	String or null
Address	String or null
Address2	String or null
City	String or null
CountyOrParish	String or null
Latitude	String or null
Longitude	String or null
StateOrProvince	String or null
PostalCode	String or null
Community	String or null
LotSizeSquareFeet	Integer or Null
InternetEntireListingDisplayYN	Boolean
MiddleOrJuniorSchool	String or null
ListOfficeAOR	String or null
ListOfficeAORArea	String or null
PoolYN	Boolean or null
PropertyType	String or null
TaxAnnualAmount	Integer or null
TaxYear	Integer or null
SingleStory	Boolean or null
LivingArea	Integer or null
ViewYN	Boolean or null
YearBuilt	Integer or null
OnMarket	Boolean or null
Status	String or null
MoxiWorksListingId	String
AgentCreatedListing	Boolean
VirtualTourURL	String
SharedPartnerData	Hash
ListingURL	String or null
PropertyFeatures	Array
CompanyListingAttributes	Array
OpenHouse	Array
ListingImages	Array

LotSizeAcres This is the property size of the listing land in acres. If no data is available for this attribute, it will be null.

BathroomsFull This is the number of full bathrooms in the property. If no data is available for this attribute, it will be null.

BathroomsHalf This is the number of half bathrooms in the property. If no data is available for this attribute, it will be null.

BathroomsOneQuarter This is the number of quarter-sized bathrooms in the property. If no data is available for this attribute, it will be null.

BathroomsPartial This is the number of partial bathrooms in the property. If no data is available for this attribute, it will be null.

BathroomsThreeQuarter This is the number of three-quarter bathrooms in the property. If no data is available for this attribute, it will be null.

BathroomsTotalInteger This is the number of rooms that are bathrooms in the property. This is not a summary count of bathrooms by size. If no data is available for this attribute, it will be null.

BathroomsTotal This is the summary count of bathrooms in the property. This will be the number of quarter-bathrooms plus half-bathrooms plus three-quarter bathrooms plus full bathrooms. If no data is available for this attribute, it will be null.

BedroomsTotal This is the number of bedrooms in the property. If no data is available for this attribute, it will be null.

PublicTitle The human-readable title for the listing generated by the property agent. If no data is available for this attribute, it will be null.

PublicRemarks These are human-readable notes about the property generated by the property agent. If no data is available for this attribute, it will be null.

ModificationTimestamp This is a string representing a date on which the listing data was last updated in ISO 8601 format. If no data is available for this attribute, it will be null.

InternetAddressDisplayYN This denotes whether the property should be displayed on a public facing website. If no data is available for this attribute, it will be null.

DaysOnMarket The number of days the listing has been on market.

ListingContractDate This is a string representing a date on which the listing contract was initiated. The string format is MM/DD/YYYY.

CreatedDate This is a string representing a date on which the Listing object was created. The string format is MM/DD/YYYY.

ElementarySchool The elementary school for the property.

GarageSpaces The number of garage spaces that are available at the property.

WaterfrontYN Whether the property is waterfront.

HighSchool The high school for the property.

AssociationFee The home owner’s association fee for the property.

ListOfficeName The name of the listing office.

ListPrice The listed price for the listing.

ListingID The MLS number for the listing.

ListAgentFullName The name of the listing agent.

ListAgentUUID A unique identifier for the listing agent. This will correspond to the uuid field of an Agent.

ListAgentOfficeID A unique identifier for the listing agent’s office. This will correspond to the office_id field of an Office.

ListAgentMoxiWorksOfficeID A unique identifier for the listing agent’s office. This will correspond to the moxi_works_office_id field of an Office.

SecondaryListAgentFullName If there is a second listing agent, the name of the second listing agent.

SecondaryListAgentUUID If there is a second listing agent, the unique identifier for the second listing agent. This will correspond to the uuid field of an Agent.

SchoolDistrict The school district the listing property is in.

Address The street address of the property.

Address2 Additional street address information, for example, suite number.

City City or township the property is located in.

State State or province the property is located in.

PostalCode The zip code or postal code the property is located in.

Community The communitythe property is located in.

LotSizeSquareFeet Total area of the lot.

InternetEntireListingDisplayYN Whether to display information about this listing publicly. If this is false, then the information about this listing should not be visible to the Internet.

MiddleOrJuniorSchool The middle school for the property.

ListOfficeAOR The name of the MLS which this listing is listed with.

ListOfficeAORArea The MLS Area which this listing is in.

PoolYN Whether the property has a pool.

PropertyType The type of property being listed. This can be one of Residential, Condo-Coop, Townhouse, Land, Multifamily

TaxAnnualAmount The total annual property tax.

TaxYear The tax year that the property tax in TaxAnnualAmount was assessed.

SingleStory Whether the building has one story or is multi-story.

LivingArea Total square footage of the building(s) on the property.

ViewYN Whether the property has a view.

YearBuilt The year the living building(s) on the property were built.

OnMarket Whether the listing is currently on-market.

Status Detailed status of the listing; whether it’s active pending contingent

MoxiWorksListingID The unique Identifier for the listing in The MoxiWorks Platform.

AgentCreatedListing Whether the agent created this listing.

VirtualTourURL Virtual tour URL for this listing.

SharedPartnerData A hash containing data shared between MoxiWorks affiliates.

ListingURL Details URL for this listing.

PropertyFeatures Any defined features about the property.

CompanyListingAttributes Company specific attributes associated with the listing. These will be defined by the company & should not be expected to be uniform across companies.

OpenHouse Open house data.

ListingImages Any images of the property.

PropertyFeature Objects

Each object in the PropertyFeatures array will have the following structure.

Attribute	Type
PropertyFeatureName	String
PropertyFeatureValues	Array

PropertyFeatureName Human readable name associated with the feature.

PropertyFeatureValues An array of strings which are human readable values associated with the feature.

CompanyListingAttributes Objects

Each object in the CompanyListingAttributes array will have the following structure.

Attribute	Type
AttributeId	String
AttributeName	String

AttributeId Unique ID for the attribute.

AttributeName Human readable name of the company specific listing attribute.

OpenHouse Objects

Each object in the OpenHouse array will have the following structure.

Attribute	Type
Date	String
StartTime	String
EndTime	String
VirtualOpenHouseYN	Boolean
VirtualOpenHouseURL	String
Comment	String

Date YYYY-MM-DD formatted string representing the date of the open house

StartTime HH:MM:SS formatted string representing the time when the open house starts. This is expressed in the local time where the listing is located.

EndTime HH:MM:SS formatted string representing the time when the open house ends. This is expressed in the local time where the listing is located.

VirtualOpenHouseYN Whether the Open House is a Virtual Open House.

VirtualOpenHouseURL If the Open House is a Virtual Open House, the URL that the Virtual Open House is available.

Comment Comments related to the specific Open House showing.

ListingImages Objects

Each object in the ListingImages array will have the following structure.

Attribute	Type
FullURL	String or null
GalleryURL	String or null
RawURL	String or null
SmallURL	String or null
ThumbURL	String or null
Title	String or null
IsMainListingImage	Boolean
Caption	String or null
Description	String or null
Width	Integer or null
Height	Integer or null
MimeType	String
EmbededHTMLContent	String

FullURL This is a valid URL that can be used for img src to a medium sized representation of the image. This is the medium size image returned in each object in the ListingImages array.

GalleryURL This is a valid URL that can be used for img src to a large sized representation of the image. This is the large size image returned in each object in the ListingImages array.

RawURL This is a valid URL to the raw image as uploaded. This is the largest size image returned in each object in the ListingImages array. Due to variation in size, this image should not be considered for use when displaying images rendered in a browser.

SmallURL This is a valid URL that can be used for img src to a small sized representation of the image. This is the small size image returned in each object in the ListingImages array.

ThumbURL This is a valid URL that can be used for img src to a thumbnail sized representation of the image. This is the smallest size image returned in each object in the ListingImages array.

Title Human readable title of image.

IsMainListingImage Whether this image is considered the primary image for the listing.

Caption Human readable caption for the image.

Description Human readable description of image.

Width Width of the raw image.

Height Height of the raw image.

MimeType MIME or media type of the image.

EmbededHTMLContent Embedded HTML that can be placed into a webpage – this will be used for embedded movies.

Differences From API Response

The payload of the Listing update matches the response provided via the MoxiWorks Platform API with the following exceptions:

Attributes Removed

Attribute	Use Instead

Attributes Added

Attribute	Type

Office

Office Update Data

The following attributes make up the payload of the Office type for a MoxiWorks Platform Realtime Office Update.

Office Realtime Update Payload Example

  {
    "moxi_works_office_id":"feedface-dead-beef-aadf-baddeedc645",
    "id":"1234",
    "client_office_id":"abc123",
    "image_url":"http://the.office.image/image.png",
    "name":"Bob's Better Brokerage",
    "common_name":"Bob's Salsburry Hill Branch",
    "address":"101 South Southerly Street",
    "address2":null,
    "city":"Townseville",
    "county":"Ye Olde Countrie",
    "state":"UM",
    "zip_code":"12123",
    "alt_phone":"8185551212",
    "email":"office@bobsbetterbrokers.erp",
    "facebook":null,
    "google_plus":null,
    "phone":"8185551213",
    "timezone":"Pacific Time (US & Canada)",
    "twitter":null,
    "office_website":"http://the.office.website",
    "region":"WESTERN WASHINGTON"
  }

Office Update Data

Attribute	Type
moxi_works_office_id	String
id	String
client_office_id	String
name	String or null
common_name	String or null
image_url	String or null
address	String or null
address2	String or null
city	String or null
county	String or null
state	String or null
zip_code	String or null
alt_phone	String or null
email	String or null
facebook	String or null
google_plus	String or null
phone	String or null
timezone	String or null
twitter	String or null
office_website	String or null
region	String or null
created_timestamp	Integer
deactivated_timestamp	Integer or null

moxi_works_office_id This is the MoxiWorks Platform ID of the office for this Office. This will be an RFC 4122 compliant UUID.

id An alternate integer ID of the office. If you are integrating with MoxiWorks Authentication services, you should use this ID.

client_office_id This is the ID of the office utilized by the company.

image_url URL to an image of the office. This can be null if there is no data for this attribute.

name The legal name of the office. This can be null if there is no data for this attribute.

common_name The commonly known name of the office. This can be null if there is no data for this attribute.

address The street address of the office. This can be null if there is no data for this attribute.

address2 The suite or office number of the office. This can be null if there is no data for this attribute.

city The city the office is in. This can be null if there is no data for this attribute.

county The county the office is in. This can be null if there is no data for this attribute.

state The state or provice the office is in. This can be null if there is no data for this attribute.

zip_code The postal code the office is in. This can be null if there is no data for this attribute.

alt_phone Alternate phone number for the office. This should be considered second in priority to phone_number. This can be null if there is no data for this attribute.

email This is the office’s main email address. This email address should be considered the email address the office would prefer to be contacted by. This can be null if there is no data for this attribute.

facebook Office’s Facebook page url. This can be null if there is no data for this attribute.

google_plus Office’s Google Plus account name. This can be null if there is no data for this attribute.

phone_number This is the office’s main phone number. This number should be considered the number the office would prefer to be contacted by. This can be null if there is no data for this attribute.

timezone Timezone the office is in.

twitter Office’s Twitter account name. This can be null if there is no data available for this attribute.

office_website Office’s website URL. This can be null if there is no data available for this attribute.

region The region the agent’s office is in. This can be null if there is no data for this attribute.

created_timestamp This is the Unix timestamp representing the date that this Office was created in the MoxiWorks system.

deactivated_timestamp This is the Unix timestamp representing the date that this Office was deactivated in the MoxiWorks system. This will be returned null if the office is still active.

Differences From API Response

The payload of the Listing update matches the response provided via the MoxiWorks Platform API with the following exceptions:

Attributes Removed

Attribute	Use Instead

Attributes Added

Attribute	Type