FluentCRM Integration

FluentCRM is a self-hosted email marketing and CRM plugin for WordPress. WP Smart Consent integrates with it via FluentCRM’s native PHP API — no external API key or internet connection required.

Enabling the Integration#

In the WP Smart Consent dashboard, go to CRMs & ESPs, find the FluentCRM card, open the Connection tab, and toggle it on. FluentCRM must be installed and active on the same site. No API credentials are needed.

Custom Fields#

The Custom fields tab lets you map WPSC data fields to FluentCRM custom field slugs. Add a row, select the WPSC source field on the left, and enter the FluentCRM custom field slug on the right. The slug must match exactly what is defined in FluentCRM → Contacts → Custom Fields. Slugs are case-sensitive.

Field Mapping#

The Field mapping tab maps WPSC fields to FluentCRM’s native fillable fields. Supported native keys are phone, country, state, city, postal_code, address_line_1, and address_line_2. If the destination key matches one of these, the value is written directly to the contact record. Any other destination key is treated as a custom field slug and goes into custom_values instead.

How It Works#

When an opt-in is captured, WP Smart Consent calls FluentCrmApi('contacts')->createOrUpdate() with the contact data. If the contact already exists they are updated rather than duplicated. The contact is created with source set to wpsc_checkout.

A ticked opt-in checkbox creates the contact as subscribed — added directly with no confirmation email. A contact received via Send on unchecked is created as unsubscribed — the record is stored but FluentCRM suppresses all marketing emails to them.

FluentCRM Automation Trigger#

WP Smart Consent also registers a custom FluentCRM automation trigger called WPSC Opt-in. This fires on every wpsc_optin_trigger event regardless of whether the FluentCRM direct integration is enabled — it only requires FluentCRM to be active on the site. Use it to build FluentCRM automations that respond to opt-in events from any WPSC source without needing the direct upsert path.

Options#

The Options tab has three settings.

Update existing contacts — when enabled, an existing FluentCRM contact matched by email has their fields updated on each opt-in. When disabled, existing contacts are left unchanged.

Send on unchecked — when enabled, contacts are forwarded to FluentCRM even when the opt-in checkbox was not ticked, with unsubscribed status.

Tags — a comma-separated list of tags to apply to every contact forwarded through this integration. Tags are merged with existing ones and never removed. Tags that do not exist in FluentCRM are created automatically.

Troubleshooting#

Contact not appearing — confirm the integration is enabled and FluentCRM is active. If FluentCrmApi is unavailable, FluentCRM may not have fully initialised.

Custom field values not saving — confirm the slug in the Custom fields tab exactly matches the field slug in FluentCRM → Contacts → Custom Fields.

Tags not applied — check the WPSC Logs tab to confirm the opt-in event fired, then check the contact record directly in FluentCRM.