31. Mailchimp Integration

Automatic subscriber management on form submission. PRO feature.

Form Settings

{
  "settings": {
    "mailchimp_enabled": true,
    "mailchimp_list_id": "abc123",
    "mailchimp_email_field": "field_2",
    "mailchimp_field_mapping": {
      "field_1": "FNAME",
      "field_5": "COMPANY"
    }
  }
}

Subscribe Behavior

On submission, fire_mailchimp() performs an upsert via the Forge API — existing contacts are updated, new ones are subscribed. The request requires both a Form Forge license key and a current site capability token; the plugin force-refreshes that token before connecting or sending. Empty PHP merge-field arrays are accepted as {} by the Worker, scalar merge-field values are coerced to strings, and the Mailchimp subscriber hash is calculated from the lowercase email before the Worker calls /lists/{list_id}/members/{subscriber_hash}. Errors and skipped states are written to formforge_integration_log but never block the submission.

Common Merge Tags

—