How to Use Custom Fields in Integration

When building complex quotes in DealHub, you often need to include specific information from your CRM that goes beyond standard fields. Whether it's special pricing tiers, customer-specific discounts, or industry-specific requirements, custom fields make it possible to carry this crucial information into your quotes.

Why Use Custom Fields?

Custom fields serve as the bridge between your CRM and DealHub quotes. They enable you to:

• Create more accurate quotes by bringing in customer-specific information like negotiated rates or volume discounts.
• Build smarter pricing rules that consider factors unique to your business, such as customer loyalty status or market segment.
• Maintain data consistency by ensuring that important CRM data is reflected in your quotes and remains synchronized.
• Enable specialized workflows that match your business processes, such as approval chains based on custom criteria.

📘

Tip

Think of custom fields as a way to extend DealHub's capabilities to match your exact business needs. Any important data point in your CRM can be made available in your quotes.

Available Custom Field Types

DealHub offers different types of custom fields, each designed for specific kinds of data. Choose the right type based on what information you need to capture:

Setting Up Custom Fields

To start using custom fields in your integration:

1. Work with your DealHub administrator to define the fields you need. They'll need to configure these in the CPQ system first.

2. Identify which type of field best suits each piece of data:

   • Numbers for quantities and amounts
   • Text for descriptions and notes
   • Lists for predefined options
   • Dates for temporal information

3. Map your CRM fields to the corresponding DealHub custom fields:

   JavaScript

   const customFieldDefinitions = {
     annual_revenue: {
       type: 'numeric',
       description: 'Annual revenue in USD'
     },
     industry: {
       type: 'text',
       description: 'Customer industry sector'
     },
     product_features: {
       type: 'text_list',
       description: 'Selected product features',
       isMultiSelect: true
     },
     contract_date: {
       type: 'utc_date',
       description: 'Contract start date'
     }
   };
   

📘

Tip

Field names are case-insensitive, making your integration more robust. However, it's good practice to maintain consistent naming.

Using Custom Fields in Quotes

Once configured, you can include custom fields when creating or updating quotes. The fields will:

• Automatically sync with your quote data
• Be available for use in pricing rules
• Appear in relevant quote sections
• Update when CRM data changes (for draft quotes)

Here's how to include custom fields when creating a quote:

const quoteData = {
  // Standard quote fields
  dealhub_user_id: "user_123",
  external_opportunity_id: "opp_456",
  
  // Custom fields
  custom_fields: [
    { name: 'annual_revenue', value: '1000000' },
    { name: 'industry', value: 'Healthcare' },
    { name: 'product_features', value: ['API Access', 'Custom Branding'] },
    { name: 'contract_start_date', value: '2025-06-13' }
  ]
};

Best Practices

• Keep field names descriptive and consistent
• Document your field mappings clearly
• Use the appropriate field type for each data point
• Validate data before sending to DealHub
• Keep field definitions up to date

📘

Tip

Remember: custom fields are powerful tools for making your quotes more dynamic and accurate. Take time to plan your field structure to match your business needs.

Next steps

Now that you finished the CRM integration section, move to the Quote Management Overview.