Connect CF7 to HubSpot

Beschreibung

Connect CF7 to HubSpot by ProCoders is a powerful plugin that connects WordPress Contact Form 7 directly with your HubSpot account, automating your workflow and enhancing lead management. With this plugin, every submission from Contact Form 7 is instantly and securely synced with HubSpot, allowing you to manage contacts, track submissions, and engage with your audience without manual data entry.

Third-Party Service Integration:
This plugin integrates with HubSpot, a third-party service, to manage and sync data from Contact Form 7 submissions. By using this plugin, data collected through Contact Form 7 will be sent to HubSpot for processing and storage. Please be aware that by using this plugin, you agree to the terms of service and privacy policy of HubSpot.
This plugin interacts with the HubSpot service and sends data to it. Specifically, our plugin sends requests to the following URLs:
– https://api.hubapi.com
– https://api.hsforms.com

Please read HubSpot’s Privacy Policy carefully to understand what data is collected and how it is used.
HubSpot’s Privacy Policy: https://legal.hubspot.com/privacy-policy
HubSpot Terms of Service: View Terms – https://legal.hubspot.com/terms-of-service

Features include:
– Send one Contact Form 7 form to several HubSpot objects at once: a Contact, a Company, a Deal and a Ticket, each with its own field mapping and associated with an object above it. Or send it to a single HubSpot form.
– Contacts: update the existing contact when the email already exists, or always create a new one.
– Deals: choose the pipeline and the deal stage.
– Attach uploaded files to the records that map them.
– Consent: block a submission when the email is unsubscribed from the subscription types you choose, or when HubSpot cannot be asked.
– Support for custom fields in HubSpot, with property lists you can refresh from Settings.
– Logs of failed, blocked and retried submissions, with personal data masked, and error emails that do not flood your inbox.
– Optional asynchronous submissions, UTM and click id attribution, and HubSpot journey events.
– Admin screens in the WordPress look: a forms list with status tabs and search, and one card per HubSpot object on the mapping screen.

Several HubSpot objects per form (since 1.4)
On a form’s mapping screen each HubSpot object is one card, titled „#1 Contact“, „#2 Deal“ and so on. Add an object, pick its type, map the Contact Form 7 fields to its HubSpot properties, and choose which object above it it is associated with. A HubSpot form target stays a single object. Fields you leave unmapped are listed under the card („Not sent: …“) so nothing is missed by accident.

Logs and error emails (since 1.4)
Failed, blocked and retried submissions are stored in their own database table with personal data masked, and kept for 30 days (filter cf7hs_log_ttl_days). On the Logs screen you can search, switch between results (Failed, Blocked, Retried, Warning) and filter by form; an entry opens right under its row with the masked request, the properties HubSpot rejected highlighted, and a „Copy details“ button for support. Error emails carry a masked summary and a link to the entry. Repeats of the same kind of failure within an hour are counted rather than mailed, and summarised when the hour ends (filter cf7hs_error_email_throttle_seconds).

Asynchronous HubSpot submissions (optional, since 1.3)
Want forms to feel instant for visitors while HubSpot catches up behind the scenes? Turn on async mode in the plugin settings. The visitor’s submission is accepted by Contact Form 7 without waiting on HubSpot network round-trips; syncing runs as a background job so thank-you pages and redirects stay snappy even when APIs are slow or busy.

The queue uses Action Scheduler when it is available on your site (for example alongside WooCommerce), which is built for reliable background work. If Action Scheduler is not present, the plugin falls back to WordPress cron with a sensible delay. Failed jobs are retried automatically with exponential backoff (up to three attempts), reducing the chance of losing a lead to a temporary outage or rate limit. Contacts, deals, HubSpot forms, and file attachments are supported in async mode the same way as synchronous processing—attachments are staged safely for the worker.

Privacy

Attribution cookies are off by default. When you turn on „Attribution cookies“ in the plugin settings, the site stores the campaign parameters (utm_source, utm_medium, utm_campaign, utm_term, utm_content) and ad click ids (gclid, fbclid) of the visitor’s landing page in first-party cookies named cf7hs_* for up to 30 days (some browsers shorten this). When a consent plugin supports the WP Consent API, the cookies are set only after marketing consent. The values are sent to HubSpot with a contact form the visitor submits. Marketing cookies may need visitor consent where the law requires it.