Hubspot Field Mapping Details
This article reviews the flow of data between MonetizeNow and Hubspot using our Hubspot Connector with no customization
What data is synced between MonetizeNow and Hubspot? And when?
Account
| Monetize Now Field | HubSpot Field (Custom) | Description |
|---|---|---|
| accountName | name | Required field. |
| Account ID | monetize_account_id | Used for linking entities. |
| defaultCurrency | Default Currency | Uses company's default currency if available. |
| status | (System Default) | Set to ACTIVE for new accounts. |
| isTestAccount | (System Default) | Set to false for new accounts. |
| Billing Address | ||
| Address Line 1 | invoice_address | Logic: If empty, falls back to address. |
| Address Line 2 | invoice_address2 | Logic: If empty, falls back to address2. |
| City | invoice_city | Logic: If empty, falls back to city. |
| State | invoice_state | Logic: If empty, falls back to state. |
| Postal Code | invoice_zip | Logic: If empty, falls back to zip. |
| Country | invoice_country | Logic: If empty, falls back to country. |
| Shipping Address | ||
| Address Line 1 | address | Used for Shipping Address. |
| Address Line 2 | address2 | Used for Shipping Address. |
| City | city | Used for Shipping Address. |
| State | state | Used for Shipping Address. |
| Postal Code | zip | Used for Shipping Address. |
| Country | country | Used for Shipping Address. |
Contact
| Monetize Now Field | HubSpot Field (Custom) | Description |
|---|---|---|
| fullName | firstname + lastname | Logic: Concatenates First + Last. If both empty, uses "Unnamed HubSpot Contact". |
| Required field. | ||
| phone | phone | Direct mapping. |
| title | jobtitle | Direct mapping. |
| Contact ID | monetize_contact_id | Link field. HubSpot does not enforce uniqueness here. |
| status | (System Default) | Set to ACTIVE. |
| primary | (System Default) | Set to false by default. |
| Address | ||
| Address Line 1 | address | Note: No Line 2 available for contacts. |
| City | city | |
| State | state | |
| Postal Code | zip | |
| Country | country |
Deal
| Monetize Now Field | HubSpot Field (Custom) | Description |
|---|---|---|
| Deal Data | ||
| Quote Type | monetize_quote_type | Enum: New, Amendment, Renewal |
| Opportunity ID | monetize_opportunity_id | Unique constraint. |
| Quote Data | ||
| Quote ID | monetize_quote_id | Unique constraint. |
| Quote Status | monetize_quote_status | Enum (e.g., DRAFT, SENT, ACCEPTED). |
| Contract Start Date | monetize_contract_start_date | |
| Contract End Date | monetize_contract_end_date | |
| Quote ARR | monetize_quote_arr | Annual Recurring Revenue. |
| Quote MRR | monetize_quote_mrr | Monthly Recurring Revenue. |
| Incremental ARR | monetize_quote_incremental_arr | |
| Incremental MRR | monetize_quote_incremental_mrr | |
| ARR Year 1 | monetize_arr_first_year | |
| ARR Year 2 | monetize_arr_second_year | |
| ARR Year 3 | monetize_arr_third_year | |
| Contract Data | ||
| Contract ID | monetize_contract_id | |
| Contract Status | monetize_contract_status | Enum: ACTIVE, CANCELED, FINISHED, PENDING |
| End Action | monetize_contract_end_action | |
| Latest Quote ID | monetize_latest_quote_id | |
| Previous Contract ID | monetize_previous_contract_id |
Product
| Monetize Now Field | HubSpot Field (Custom) | Description |
|---|---|---|
| Product ID | monetize_product_id | |
| Price ID | monetize_price_id | Unique constraint. |
| Rate ID | monetize_rate_id | |
| Offering ID | monetize_offering_id | |
| Billing Frequency | monetize_usage_billing_frequency | For usage products. |
Line Item
| Monetize Now Field | HubSpot Field (Custom) | Description |
|---|---|---|
| Quote Item ID | monetize_quoteitem_id | Unique constraint. |
| Unit Price | monetize_quoteitem_unit_price | |
| Quantity | monetize_quoteitem_quantity | |
| Discount % | monetize_quoteitem_discount_percentage | |
| Discount Amount | monetize_quoteitem_discount_amount | |
| MRR | monetize_quoteitem_mrr | |
| ARR | monetize_quoteitem_arr |
Address Automation Logic (for Webhooks)
| Event | Action | Impact on MonetizeNow |
|---|---|---|
| HubSpot Company Address Change | Webhook Triggered | 1. Updates MN Account Billing Address.2. Updates MN Account Shipping Address.3. Updates ALL associated Contacts with the new Shipping Address. |
| HubSpot Contact Address Change | Webhook Triggered | Updates specific MN Contact address. |
| Wait Logic | API Rate Limiting | 200ms delay between contact updates; 10s retry logic for companies. |
Hubspot to MonetizeNow
Hubspot is the source of truth for the following records and shares the outlined data to MonetizeNow. MonetizeNow will only write to specified fields that it owns on these records, detailed below.
Record | When Hubspot updates show up in MonetizeNow |
|---|---|
Company | Instantly. After any update to a monitored field (see table below). |
Contact | Instantly. After any update to a monitored field (see table below). |
Deal | Only prior to Quote creation. Note Deal data itself is not stored in MonetizeNow. Instead, Deals are used to organize and pre-populate Draft Quotes in MonetizeNow. Conversely, as Quotes progress past the Draft state, MonetizeNow will own updating the Deal. |
MonetizeNow to Hubspot
MonetizeNow is the source of truth for the following records and shares the outlined data to Hubspot.
| Record | When MonetizeNow updates show up in SFDC |
|---|---|
| Company (Select Fields) | Instantly. After any update to a monitored field (see table below). |
| Contact (Select Fields) | Instantly. After any update to a monitored field (see table below). |
| Deal (Select Fields) | Instantly. After any update to a monitored field (see table below). |
Hubspot Monitored Fields (Hubspot is the Source of Truth)
| Record | Field |
|---|---|
| Company | name |
| Company | vat_registration_number |
| Company | company_registration_number |
| Company | billing_language |
| Company | e_invoice_endpoint_id |
| Company | e_invoice_endpoint_scheme |
| Company | address |
| Company | address2 |
| Company | city |
| Company | state |
| Company | zip |
| Company | country |
| Company | invoice_address |
| Company | invoice_address2 |
| Company | invoice_city |
| Company | invoice_state |
| Company | invoice_zip |
| Company | invoice_country |
| Company | +Any Other Desired Fields* |
| Contact | firstname |
| Contact | lastname |
| Contact | |
| Contact | phone |
| Contact | +Any Other Desired Fields* |
*MonetizeNow will monitor any additional fields explicitly defined as a Custom Field. These are data elements can be used for Approval Rules, Conditional Logic, Quote Terms, Finance IDs, manage Ship To vs. Bill To Contacts, and what ever else you can imagine. Click here to learn more about setting up custom fields.
Note MonetizeNow supports creating and updating Company and Contact data directly in MonetizeNow, however, when used with a CRM such as Hubspot, we advise against it, to keep processes simple and data flows clean.
Hubspot Monitored Fields (MonetizeNow is the Source of Truth)
| Record | Field |
|---|---|
| Company | monetizeId |
| Contact | monetizeId |
| Deal | opportunityId |
| Deal | quoteId |
| Deal | quoteType |
| Deal | quoteStatus |
| Deal | quoteARR |
| Deal | quote Incremental ARR |
| Deal | quoteMRR |
| Deal | quote Incremental MRR |
| Deal | contractEndAction |
| Deal | contractStatus |
| Deal | contractStartDate |
| Deal | contractEndDate |
| Deal | previousContractID |
| Deal | +Any Other Desired Fields* |
How do Hubspot Deals get associated with MonetizeNow Quotes?
No matter how you want to run your business. MonetizeNow ensures your CRM is fully informed and connected to the latest information in MonetizeNow. There are three primary ways this happens:
- A HS Deal Already Exists and "Create Quote" is selected on the HS Deal.
- A MonetizeNow Quote is created
- The MonetizeNow Quote is automatically associated with this Deal.
- The MonetizeNow Quote with allow you to associate this Quote with an existing contract to have a Deal reflect an Amendment or a Renewal.
- A MonetizeNow Contract Already Exists and clicking "Amend" or "Renew" on the Contract Card in HS.
- A MonetizeNow Quote is created
- A HS Deal is created
- The MonetizeNow Quote is automatically associated with the HS Deal.
- The MonetizeNow Quote is automatically connected to the existing Contract
- Nothing currently exists and a Quote is created directly from MonetizeNow.
- A MonetizeNow Quote is created
- A HS Deal is created
- The MonetizeNow Quote is automatically associated with the HS Deal.
- The MonetizeNow Quote with allow you to associate this Quote with an existing contract to have a Deal reflect an Amendment or a Renewal.
Does MonetizeNow allow setting Legal Entity from Hubspot for a Deal.
Yes, we support that. For that, first, you need to configure Legal Entities in HubSpot. Things to note:
- Make sure that it is a "mandatory" field
- To see the legal entity easily for a Deal, have it show up under the "About this Deal" card.
Then, above entities need to be mapped to Legal entities that are configured in MonetizeNow. Note that you can configure the Legal Entities in MonetizeNow as a first step as well.
Now, we will test how the Legal entity will flow from Hubspot to MonetizeNow for a new deal.
Can I change the Legal Entity for a Deal after the quote has been created?
Yes. To do this, first the sales rep needs to change the legal entity on the deal and then hit "create quote" in the MonetizeNow card. The new quote will belong to the new legal entity.
Updated 4 days ago