fluentcrm-contact-models

FluentCRM: contact, list, tag, and user models

Use this skill for companion plugins that need to write or query FluentCRM contacts. Prefer FluentCrmApi() wrappers for writes, and use the ORM models for reads, reports, migrations, and carefully scoped queries.

Verification note: this skill is based on FluentCRM core 3.1.13 source. The contact/list/tag/user APIs covered here are core APIs and do not require FluentCampaign Pro.

When to use this skill

• Creating or updating contacts from a third-party plugin, webhook, form, order, LMS event, or user registration.
• Adding or removing FluentCRM lists/tags from a contact.
• Querying contacts by list, tag, status, SMS status, company, search, custom field, or advanced filter provider.
• Mapping a WordPress user to a FluentCRM contact.
• Reviewing code that touches Subscriber::create(), Subscriber::updateOrCreate(), attachLists(), attachTags(), fluentcrm_subscriber_statuses(), or ContactsQuery.

API entry points

Guard companion plugin code and run after FluentCRM has loaded:

if (!function_exists('FluentCrmApi')) {
    return;
}

$contactApi = FluentCrmApi('contacts');
$listApi    = FluentCrmApi('lists');
$tagApi     = FluentCrmApi('tags');

app/Api/config.php registers these keys: contacts, tags, lists, extender, companies, and event_tracker.

Prefer:

$contact = FluentCrmApi('contacts')->createOrUpdate([
    'email'         => sanitize_email($email),
    'first_name'    => sanitize_text_field($firstName),
    'last_name'     => sanitize_text_field($lastName),
    'user_id'       => (int) $userId,
    'status'        => 'subscribed',
    'source'        => 'my-plugin',
    'lists'         => [3],
    'tags'          => [12],
    'custom_values' => [
        'plan' => sanitize_text_field($plan),
    ],
], false, false);

Do not create contacts with raw $wpdb inserts. Direct Subscriber::create() skips several integration-level behaviors. FluentCrmApi('contacts')->createOrUpdate() delegates to Subscriber::updateOrCreate(), syncs lists/tags/custom fields, links a WP user by email when possible, and fires the contact lifecycle hooks.