The Company Profile iFrame allows you to embed Dealfront’s company data directly inside your own systems, tools, or internal dashboards. By passing a set of attributes into the iFrame, Dealfront will automatically try to identify and display the best possible company match from our database.
This makes it easy for your teams to access reliable firmographic details without switching systems.
Example setup of Dealfront Company Profile Standalone iFrame in a custom implemented CRM system.
Prerequisites
To load and view the Company Profile iFrame:
The user opening the iFrame must have a valid Dealfront login.
If they do not yet have an account, they can start a free trial and access it in minutes.
Once authenticated, the embedded view will automatically adapt to their permissions and data access.
How Company Matching Works
Company matching is required to connect the company that a user is currently working with in an external system to the correct company profile displayed inside the Company Profile iFrame.
Because the iFrame is embedded inside another platform, Dealfront needs a reliable way to understand which company the user is accessing and ensure that the information shown in the iFrame is relevant to that specific context.
To achieve this, the embedding system passes company-related attributes such as company name, website, or address details to the iFrame. Dealfront then uses these inputs to identify the best possible matching company from its database and display it inside the iFrame.
Matching works even with partial information, but providing more accurate and consistent attributes increases match quality and reduces ambiguity.
Available Configuration Parameters
Before appending parameters, the Company Profile iFrame is always loaded from:
All parameters listed below can be added to the base URL as query parameters to refine the match.
Parameter | Description |
company_name | Name of the company you want to match |
url | Company website URL |
street | Street name and number (combined) |
street_number | Street number only |
country | Country name |
country_code | ISO 3166-1 Alpha-2 country code |
zip | Postal code |
location | City name |
phone | Company phone number |
vat_id | VAT identification number |
register_id | Commercial register ID |
register_location | Registration location |
Note: You do not need to provide all fields. Matching works with partial data, but more attributes improve accuracy.
Passing Custom Data Through the iFrame
If you also want to pass external IDs (for example, internal system identifiers), the iFrame supports optional custom parameters.
These are also used when the integration is connected to Dealfront’s Webhooks.
Parameter | Description |
params.custom_id | Any internal identifier you want to reference later |
params.user_id | Used to pass the acting user or process owner |
You can learn more about Webhooks configuration here: Using Webhooks with Dealfront
Embedding the iFrame
You can include this in any <iframe> element inside your tool, app, or dashboard:
HTML
<iframe src="https://integrations.dealfront.com/company-profile?company_name=Dealfront&country_code=DE" width="100%" height="600">
</iframe>
Migrating from the Legacy “Echobot CONNECT” iFrame
If you previously used the Echobot CONNECT iFrame, you can migrate smoothly using the mapping table below.
Replace any legacy parameters with the new equivalents when building the Company Profile iFrame.
Legacy iFrame query parameter | New iFrame query parameter |
companyName | company_name |
url | url |
street | street |
streetNumber | street_number |
zip | zip |
location | location |
phone | phone |
ustId | vat_id |
hrId | register_id |
hrLocation | register_location |
customId | params.custom_id |
userId | params.user_id |
Still unsure how to move forward? Check our Academy Videos, contact us via support@dealfront.com or use the live chat. We're happy to guide you.
RELATED: