CRM Guide: How to Integrate with Blend

Overview

This guide will cover the common patterns that CRM partners use to integrate with Blend, and point you to all the
resources you need to enact those patterns for your CRM.

CRM Patterns

There are 2 main patterns for CRM integrations:

1. One-way to Blend
2. One-way from Blend

One-way integrations send consumer data to Blend in order to start a loan or other transaction. The CRM does not receive updates as the consumer moves through stages of the transaction or if the consumer's data is updated in Blend.

One-way integrations are easier to set-up, but less featureful for customers. 

Two-way integrations both post consumer data into Blend AND receive updates on that consumer if their information is updated or as they move through the transaction. This maintains a consistent picture of the consumer in both systems. 

One-Way Integration Walkthrough

One-way CRM integrations are usually initiated from the CRM's side, either by allowing users to manually trigger sending a consumer's information to Blend, or automatically triggering the integration to Blend based on logic in the CRM (lead moved to active, e.g.). A consumer must be tied to at least 1 loan or banking transaction in Blend, which means this process must also create the Loan the consumer will be attached to.

Follow the steps on the Create a New Home Loan page to create a loan and add consumers and their information to the loan.

Once the information has been sent to Blend, the CRM will not get updates about changes to any of this information in Blend.

Two-Way Integration Walkthrough

Two-way CRM integrations still usually start on the CRM's side, with the CRM initiating a loan and consumers in Blend just like the above. However, unlike the above, CRM's can get structured updates on when changes occur by subscribing to the appropriate Event Notifications. 

In addition to the instructions outlined above, you will also need to subscribe to Blend's Event Notifications to enable two-way data syncing. 

Blend's Event Notifications utilize standard webhook architecture.
In order to receive Blend Event Notifications, you will have to create an endpoint that can receive and parse the events, and contact Blend in order to get your subscription set up properly. 

See Getting Started with Blend Events for how to get setup receiving event notifications,
and Blend Event Glossary to select which events you need to subscribe to. 

Once you are receiving Event Notifications on consumer updates, you will need to write logic on the CRM side to decide what to do with those events. Usually you want to update the consumer's information in your system, or update the status of the consumer/lead/opportunity.

In the final system, the process will look like this: 

1. CRM creates loan and consumer in Blend
2. Consumers use Blend and update some of their information
3. CRM gets an event notification that consumers information has been updated
4. CRM calls Blend's API to get the information that needs to be updated and makes the changes in it's systems
5. Consumers submit their application
6. CRM gets an event notification that the loan status has been updated
7. CRM may call Blend's APIs to get additional information or not
8. CRM updates the Lead/Opportunity in it's systems

🚧

Identifying Loan Source

Make sure to include applicationSource 'type' and 'name' values when you create loans in Blend via a POST /loans call,
this way your lender teams will be able to use the "Source Type" or "Source Name" filters in their pipeline to
distinguish loans the originated in your LOS from those they originate in Blend. For more information, please see our
Loan Request Schema documentation.

Additional Information

If you want to allow Lenders or Bankers to seamlessly move between the LOS and Blend, see 
Leveraging Lender SSO for Integrations.