Centous Integration for HubSpot with Contact Form 7, WPForms, Elementor Forms, and Formidable Forms

Centous Integration for HubSpot connects Contact Form 7, WPForms, Elementor Pro, and Formidable Forms submissions directly to HubSpot CRM using secure OAuth authentication.

Using this plugin, form submissions from Contact Form 7, WPForms, Elementor, or Formidable Forms can be automatically sent to HubSpot as Contacts, Companies, or Deals, helping you manage customer data efficiently without manual entry.

This plugin is not affiliated with or endorsed by HubSpot, Inc.

Key Features

Integration with multiple form plugins:
– Contact Form 7 support
– WPForms support
– Elementor Pro form support
– Formidable Forms support

HubSpot CRM object support:
– Contacts
– Companies
– Deals

Core features:
– Secure OAuth 2.0 based HubSpot authentication
– Create and manage multiple form-to-HubSpot integrations
– Advanced field mapping between form fields and HubSpot properties
– Test connection and verify HubSpot credentials
– Add notes to HubSpot records from WordPress logs
– Comprehensive API request and response logging
– Detailed error tracking and debugging tools
– Clean uninstall option (optional data removal)
– Restructured architecture for improved performance

Supported Contact Forms

• Contact Form 7 (https://wordpress.org/plugins/contact-form-7/)
• WPForms (https://wpforms.com/)
• Elementor Pro (https://elementor.com/pro/) — Form widget required
• Formidable Forms (https://wordpress.org/plugins/formidable/)

You can integrate multiple forms from either plugin or both simultaneously.

Why We Built This Plugin

HubSpot CRM is a powerful platform for managing customer relationships. By integrating it with popular WordPress form plugins like Contact Form 7 and WPForms, we wanted to make it easier for WordPress users to send contact and lead data directly to HubSpot and automate their sales and marketing workflows.

Usage

Basic Setup

1. Connect your HubSpot account from the plugin settings
2. Create an integration feed and choose a Contact Form 7 or WPForms form
3. Select the HubSpot object (Contact, Company, or Deal)
4. Map form fields to HubSpot properties
5. Save the integration
6. Form submissions will now be sent to HubSpot automatically

Contact Form 7 Integration

1. Ensure Contact Form 7 is installed and activated
2. Create a Contact Form 7 form or use an existing one
3. Go to HubSpot Connect → Integrations
4. Click Add New Integration
5. Under “Form Type”, select Contact Form 7
6. Select your Contact Form 7 form from the dropdown
7. Configure field mapping (see Field Mapping section below)
8. Save the integration

WPForms Integration

1. Ensure WPForms plugin is installed and activated
2. Create a WPForms form or use an existing one
3. Go to HubSpot Connect → Integrations
4. Click Add New Integration
5. Under “Form Type”, select WPForms
6. Select your WPForms form from the dropdown
7. Configure field mapping (see Field Mapping section below)
8. Save the integration

External Services

This plugin connects to the HubSpot CRM API (a third-party service provided by HubSpot, Inc.) to send form submission data to your HubSpot CRM account. This connection is required for the plugin to function. Without it, the plugin cannot create Contacts, Companies, or Deals in HubSpot.

What the service is and what it is used for

The plugin uses HubSpot CRM to store and manage contact and lead data submitted through Contact Form 7 and WPForms forms. It allows site owners to automatically create or update Contacts, Companies, and Deals in their HubSpot CRM account, and to add notes to those records.

What data is sent and when

Data is sent to HubSpot in the following situations:

1. When the site administrator connects their HubSpot account using OAuth 2.0 authentication, OAuth authorization codes and access tokens are exchanged with HubSpot.

2. When the administrator clicks “Test Connection”, a verification request is sent to HubSpot to confirm the access token is valid.

3. When a visitor submits a Contact Form 7 or WPForms form and an active integration is configured for that form, the submitted form data is sent to HubSpot. Depending on the integration configuration, this may include: name, email address, phone number, company name, message, and any custom form fields the administrator has mapped.

4. When the administrator adds a note to a HubSpot record from the plugin’s Logs screen, the note content is sent to HubSpot.

No data is sent to HubSpot until the administrator has connected an account and configured an active integration.

Service provider

This service is provided by HubSpot, Inc.

Service website: https://www.hubspot.com/
API domain: https://api.hubapi.com/
Terms of Service: https://legal.hubspot.com/terms-of-service
Privacy Policy: https://legal.hubspot.com/privacy-policy

HubSpot API endpoints used by this plugin

• https://app.hubspot.com/oauth/authorize
• https://api.hubapi.com/oauth/v1/token
• https://api.hubapi.com/account-info/v3/details
• https://api.hubapi.com/crm/v3/objects/notes
• https://api.hubapi.com/crm/v3/objects/{objectType}
• https://api.hubapi.com/crm/v3/objects/{objectType}/search
• https://api.hubapi.com/crm/v3/objects/{objectType}/{objectId}
• https://api.hubapi.com/crm/v3/properties/{objectType}
• https://api.hubapi.com/crm/v3/pipelines/deals

Site owners are responsible for informing their users about this data transmission and obtaining any consent required under GDPR or other applicable privacy laws before collecting and sending personal data to HubSpot.

Configuration

The plugin uses a modernized integration-based configuration system, allowing you to control which forms send data to HubSpot and how the data is mapped.

Plugin Menu Structure

After activation, the following menu appears in the WordPress admin sidebar:

HubSpot Connect
– HubSpot Connect (connection setup)
– Test Connection
– Integrations
– Logs
– Settings

1. HubSpot Connect (Connection Setup)

1. Go to HubSpot Connect → HubSpot Connect
2. Enter an Account Name
3. Enter your HubSpot OAuth credentials (Client ID and Client Secret)
4. Click Connect Account
5. Log in to your HubSpot account and approve access
6. Once connected, your HubSpot account details will be displayed

2. Test Connection

1. Navigate to HubSpot Connect → Test Connection
2. Click the Test Connection button
3. The plugin will verify OAuth authentication, access token validity, and HubSpot API connectivity

3. Integrations

Integrations control how form submissions are sent to HubSpot.

Create a New Integration

1. Go to HubSpot Connect → Integrations and click Add New Integration
2. Configure the following:

a) Select Form Type
Choose which form plugin to integrate:
– Contact Form 7
– WPForms

b) Select Form
Choose the specific form from your selected form plugin.

c) Select HubSpot Object Type
Choose where to send data:
– Contacts – Create or update contact records
– Companies – Create or update company records
– Deals – Create or update deal records

d) Field Mapping

Map your form fields to HubSpot properties.

Contact Form 7 Example:
– HubSpot “First Name” → CF7 [text first-name]
– HubSpot “Email” → CF7 [email* your-email]
– HubSpot “Phone” → CF7 [tel your-phone]
– HubSpot “Company” → CF7 [text company-name]

WPForms Example:
– HubSpot “First Name” → Name field (Field ID)
– HubSpot “Email” → Email field (Field ID)
– HubSpot “Phone” → Phone field (Field ID)
– HubSpot “Company” → Text field (Field ID)

e) Integration Status
– Enable or disable integration using the Active/Inactive toggle
– Only active integrations send data to HubSpot

Manage Integrations

• Edit – Modify existing integration settings
• Test – Send a test submission to verify the integration
• Duplicate – Clone an existing integration for quick setup
• Delete – Remove an integration
• View Logs – Check logs specific to this integration

4. Logs

1. Go to HubSpot Connect → Logs to view API request and response logs
2. Features include:
   • View API requests sent to HubSpot
   • View API responses from HubSpot
   • Check error messages and debugging information
   • See timestamp of each submission attempt
   • View integration/form associated with the submission
   • Check submission status (success/failed)
3. You can also add internal notes to HubSpot records directly from the log screen
4. Filter and search logs for quick troubleshooting

5. Settings

Navigate to HubSpot Connect → Settings to configure global plugin options:

• Enable / disable logging
• Delete plugin data on uninstall
• Log retention period
• Date format
• API timeout settings

Privacy and Data Handling

This plugin stores form submission data in the WordPress database for processing, logging, and integration with HubSpot.

Data that may be stored includes:

• Name
• Email address
• Phone number
• Company name
• Message
• Any additional form fields submitted by the user
• HubSpot API responses and logs (if logging is enabled)
• OAuth access and refresh tokens (stored securely)

This data is used to send form submissions to HubSpot CRM and to maintain logs for debugging and tracking API activity. Data is stored in the WordPress database until manually deleted or removed during plugin uninstall (if enabled).

Site owners are responsible for informing users about data collection, obtaining user consent where required, and ensuring compliance with GDPR and other applicable laws.

Security

This plugin uses WordPress nonces and capability checks in all admin actions. Database queries are prepared and sanitized according to WordPress coding standards. Data output is escaped according to WordPress coding standards. OAuth access and refresh tokens are stored securely in the database.

Support

For support, please contact us at https://centousplugins.com/contact-us/

For full setup and usage instructions, please read our documentation:
https://docs.centousplugins.com/centous-integration-for-contact-form-7-and-wpforms-with-hubspot/

Plugin author website: https://www.centous.com/