This document covers everything you need to know about connecting FINMO to Broki — the difference between the API token and the REST hook (webhook), the complete step-by-step setup process, what being connected actually enables, and how to troubleshoot common issues including files that won't pull through.
Sections Covered
1. API Token vs. REST Hook (Webhook) — Understanding the Difference
2. What Being Connected Actually Enables
3. What You Will Need From FINMO Before Starting
4. Step-by-Step Setup — Complete Connection Guide
5. How to Update a File After Connection
6. How Each User Connects Their Own FINMO Account
7. Troubleshooting — Files That Won't Pull Through
8. Troubleshooting — Pulling Files From Another User's FINMO Account
9. Quick Reference — Where Is That Button?
1. API Token vs. REST Hook (Webhook) — Understanding the Difference
Connecting FINMO to Broki involves two separate components. It is important to understand what each one does before setting them up.
FINMO API Token | Enables manual file management between FINMO and Broki. Use the API token to: pull a specific file into Broki using a loan code, and update an existing Broki file with fresh data from FINMO at any time using the FINMO sync button. |
REST Hook (Webhook) | Enables automatic file creation in Broki. When a client fills out a FINMO application and submits it, the REST hook fires and creates the file in Broki's pipeline automatically — no manual action needed. |
Think of it this way: the API token is for manual control (pull this file, update this file), and the REST hook is for automation (create files automatically when applications come in). Both need to be connected for the full integration to work.
2. What Being Connected Actually Enables
With the API token connected
Pull any FINMO file into Broki manually using the loan code — via the + button in the pipeline and selecting Sync from FINMO.
Click the FINMO sync button (or Pull from FINMO under Actions) on any existing Broki file to pull the latest data from FINMO — useful after updating a file in FINMO.
With the REST hook connected
Every new client application submitted through FINMO automatically creates a file in your Broki pipeline — no manual import needed.
Files flow in hands-free as soon as clients complete and submit their FINMO application.
3. What You Will Need From FINMO Before Starting
Before beginning the setup in Broki, you need to collect three pieces of information from your FINMO account. All three are found in FINMO Settings → Integrations.
API Token | Generated in FINMO Settings → Integrations → FINMO API section. Click Generate New Token to create one. Copy it immediately — you will paste it into Broki. |
Team ID | Found on the same FINMO Integrations page. Copy the value shown next to Your Team ID. |
Public Key | Also on the FINMO Integrations page. Copy the Public Key value. |
⚠ Have all three values — API Token, Team ID, and Public Key — copied and ready before navigating to Broki. The setup requires all three to complete the integration.
4. Step-by-Step Setup — Complete Connection Guide
Follow these steps in order. The process moves between FINMO and Broki several times — read each step carefully before acting.
PART A — Collect credentials from FINMO
1 | Go to FINMO Settings Log into FINMO and navigate to your Settings page on the left sidebar. |
2 | Open the Integrations section Scroll down on the Settings page and click Integrations. |
3 | Find the FINMO API section On the Integrations page, locate the section labeled FINMO API (near the bottom of the page). |
4 | Generate a new API token Click Generate New Token. A token will be created and displayed. Copy this token immediately and save it somewhere safe — you will need it in Broki. |
5 | Copy your Team ID Still on the FINMO Integrations page, find Your Team ID. Copy this value. |
6 | Copy your Public Key On the same page, find and copy the Public Key value. |
You now have all three values needed: API Token, Team ID, and Public Key. Keep them handy — you are about to paste all three into Broki.
PART B — Connect the API in Broki
7 | Go to Broki Settings Log into Broki. Click the Settings button in the bottom left corner of the platform. |
8 | Open Integrations & Connections On the Settings page, scroll down the left sidebar and click Integrations & Connections. |
9 | Open Origination Platforms On the Integrations & Connections page, click Origination Platforms. |
10 | Open the FINMO integration panel Find FINMO in the list and click Manage to open the FINMO integration dropdown panel. |
11 | Paste the API token into both fields You will see two fields: FINMO API Key and Confirm API Key. Paste the API token you copied from FINMO into both fields — they must match exactly. |
12 | Paste the Team ID Find the Team ID field and paste the Team ID you copied from FINMO. |
13 | Paste the Public Key Find the Public Key field and paste the Public Key you copied from FINMO. |
14 | Click Configure Integration Click the Configure Integration button (or the purple button in the bottom right corner of the panel). The integration is saved and a webhook URL is automatically generated at the top of the panel. Copy this webhook URL — you will need it in the next step. |
PART C — Set up the REST Hook in FINMO
15 | Go back to FINMO Settings → Integrations Return to FINMO and navigate back to Settings → Integrations. |
16 | Find the REST Hook section On the Integrations page, find the section labeled REST Hook (or Create New REST Hook). |
17 | Create a new REST hook Click Create New REST Hook (or the equivalent button). |
18 | Paste the webhook URL from Broki In the URL field, paste the webhook URL that was generated in Broki after you configured the integration in Step 14. |
19 | Select the trigger event Select the trigger: When Application Submitted by Borrower. This ensures that every time a client submits a FINMO application, a file is automatically created in Broki. |
20 | Click Save Click Save to activate the REST hook. |
✓ Setup complete. Your FINMO account is now connected to Broki. Files will be created automatically when clients submit applications, and you can manually pull or update files at any time using the loan code.
5. How to Update a File After Connection
Once FINMO is connected, you have two ways to bring updated data from FINMO into an existing Broki file:
From the pipeline — pull a new file | Click the + button in the pipeline toolbar. Select Sync from FINMO. Paste the loan code of the FINMO file you want to pull in. The file is created in Broki. |
From inside a file — update existing file | Open the mortgage file in Broki. Click the Actions button in the sticky top bar. Select Pull from FINMO. The file's data is updated with the latest information from FINMO. |
Best practice: After making significant updates to a file in FINMO (e.g. after submitting to a lender or updating application details), click Pull from FINMO in Broki to keep both platforms in sync.
6. How Each User Connects Their Own FINMO Account
In Broki, each individual user connects their own personal FINMO account. The connection is not shared across all team members — it is per-user.
Every broker or team member who uses FINMO needs to complete the setup process above using their own FINMO credentials and their own API token.
When a user pulls a file from FINMO in Broki, it uses their personal connected FINMO account to fetch the data.
If a user has not connected their FINMO account, they will not be able to pull files or trigger updates from FINMO.
This is typically not an issue in day-to-day use because most files are created automatically via the REST hook when clients submit applications. The per-user API connection primarily matters when importing older files manually.
7. Troubleshooting — Files That Won't Pull Through
If you are trying to manually pull a file using a loan code and it is not working, here are the most common reasons:
API not properly connected | One or more of the three credentials (API Token, Team ID, Public Key) may have been entered incorrectly, or the integration was not saved properly. Re-open the FINMO integration panel in Broki (Settings → Integrations & Connections → Origination Platforms → FINMO → Manage) and verify all three fields are populated correctly. |
API token has expired or been regenerated | FINMO API tokens can expire or be replaced if a new token is generated. If a new token was generated in FINMO after the initial setup, you will need to paste the new token into both the FINMO API Key and Confirm API Key fields in Broki and reconfigure the integration. |
Client consent not given | FINMO restricts data sharing for files where the client did not go through the online application process and provide consent. If you filled out the application on the client's behalf and they never submitted it themselves online, the consent flag may not be set — which can prevent the file from being pulled into Broki. Once a file has been properly submitted through FINMO with client consent, it should be pullable. |
File not yet at a pullable status | Some files in FINMO may not be available to pull until they reach a certain status (e.g. after submission or validation). If a file won't pull, check the file's status in FINMO and try again once it has progressed further. |
Pulling someone else's file | If you are trying to pull a file that belongs to another broker's FINMO account and that broker's account is not the one connected in Broki, the pull will fail. See Section 8 for details. |
REST hook not saving or firing | If applications are not auto-creating in Broki, verify the REST hook was saved correctly in FINMO with the correct webhook URL and the When Application Submitted by Borrower trigger selected. Delete and recreate the REST hook if needed. |
8. Troubleshooting — Pulling Files From Another User's FINMO Account
This is a common point of confusion for teams. The key rule to understand is:
A file can only be pulled from FINMO by the user whose FINMO account it belongs to.
This is a FINMO security rule — not a Broki limitation.
What this means in practice
If a broker on your team has their own FINMO account and you (as an admin or another user) try to pull their file using your connected FINMO credentials, it will not work.
The first pull of any file must be done by the user whose FINMO account the file lives in.
Once a file has been pulled into Broki for the first time by the correct user, any team member can click Pull from FINMO on that file to refresh it — because it is already synced and linked.
How to handle this for importing old files
Have each broker log into Broki themselves and pull their own historical files using their own connected FINMO account.
Once the initial pull is done by the correct user, the file is in Broki and any team member can update it going forward.
In normal day-to-day use, this issue almost never comes up — because the REST hook creates files automatically when clients submit applications, so manual pulling is rarely needed except for importing historical files. If you are migrating older files into Broki, make sure each broker does their own initial import.
9. Quick Reference — Where Is That Button?
Button / Feature | Location | What it does |
FINMO Settings → Integrations | FINMO → Settings → Integrations (scroll down) | Where you find your API token, Team ID, Public Key, and REST hook configuration |
Generate New Token | FINMO → Settings → Integrations → FINMO API section | Creates a new API token to use in Broki — copy it immediately |
Your Team ID | FINMO → Settings → Integrations | The Team ID to paste into the Broki FINMO integration panel |
Public Key | FINMO → Settings → Integrations | The Public Key to paste into the Broki FINMO integration panel |
Create New REST Hook | FINMO → Settings → Integrations → REST Hook section | Where you paste the webhook URL from Broki and set the trigger event |
When Application Submitted by Borrower | FINMO REST hook trigger selection | The trigger that fires the webhook and creates a file in Broki when a client submits an application |
Integrations & Connections | Broki → Settings → left sidebar (scroll down) | Access all platform integrations including FINMO and Velocity |
Origination Platforms | Broki → Settings → Integrations & Connections | Find FINMO and Velocity integration management here |
FINMO → Manage | Broki → Settings → Integrations → Origination Platforms → FINMO | Open the FINMO API connection panel in Broki |
FINMO API Key field | Broki → FINMO integration panel | Paste the API token generated from FINMO here |
Confirm API Key field | Broki → FINMO integration panel | Paste the same API token here to confirm — must match exactly |
Team ID field | Broki → FINMO integration panel | Paste the Team ID from FINMO here |
Public Key field | Broki → FINMO integration panel | Paste the Public Key from FINMO here |
Configure Integration button | Broki → FINMO integration panel — bottom right | Saves all credentials and generates the webhook URL |
Webhook URL | Broki → FINMO integration panel — top, after configuring | The URL to paste into FINMO's REST hook section |
+ button (pipeline) | Broki pipeline toolbar — second row | Manually pull a FINMO file using its loan code — select Sync from FINMO |
Pull from FINMO | Inside any Broki file → Actions dropdown (sticky top bar) | Updates the current file with the latest data from FINMO |