Mail Integration (Klaviyo & Mailchimp)

Modified on Tue, 21 Jul at 1:27 AM

How to Integrate Mailchimp & Klaviyo with Hulk Form Builder


Connecting Hulk Form Builder with email service providers (ESPs) like Mailchimp and Klaviyo allows you to automatically create subscriber profiles, pass custom form attributes, and capture email marketing consent upon form submission.


1. Global Setup (Connecting Your ESP)

  1. Navigate to SettingsIntegrationsEmail Service Provider.

  2. Toggle on Enable Email Integration.

  3. Select your provider (Mailchimp or Klaviyo).

  4. Enter your provider's API Key and save changes.


2. Mailchimp Integration Setup

Step A: Obtain Your Mailchimp API Key

  1. Log in to Mailchimp and go to Account & ProfileExtrasAPI keys.

  2. Generate a new API key, copy it, and paste it into Hulk Form Builder under SettingsIntegrations.

Step B: Enable Integration on Your Form

  1. Open your target form in Hulk Form Builder.

  2. Go to SettingsIntegrationsEmail Service Provider.

  3. Enable Mailchimp Integration and select your desired Mailchimp List.

Step C: Map Fields & Consent

  • Email Marketing Consent: Add a Checkbox or Privacy Notice element to your form and set the Mailchimp Field value to accepts_marketing. Users will only be subscribed to your list if they check this box.

  • Custom Field Mapping: To sync additional form inputs to Mailchimp, create corresponding Field Tags inside your Mailchimp account first. Then, enter those matching field tags into the Mailchimp Field parameter of each form element.


3. Klaviyo Integration Setup

Step A: Obtain Your Klaviyo API Key

  1. Log in to Klaviyo and go to Account SettingsAPI Keys.

  2. Select Create Private API Key and set the access permissions to Full Access.

  3. Copy the key and paste it into Hulk Form Builder under SettingsIntegrations.

Step B: Configure Klaviyo & Enable Integration

  1. In Klaviyo, set your target list settings to Single Opt-in.

  2. Open your target form in Hulk Form Builder, navigate to Integrations, and toggle on Klaviyo Integration.

Step C: Map Fields & Supported Properties

  • Email Marketing Consent: Add a Checkbox or Privacy Notice element to your form and enter accepts_marketing into the Klaviyo Field.

Supported Klaviyo Elements & Mappings

  • Email Consent: accepts_marketing (Checkbox, Privacy Notice)

  • First Name: first_name (Single Line Text)

  • Last Name: last_name (Single Line Text)

  • Other Supported Form Elements:

    • Multi-line Text

    • Dropdown

    • Radio Buttons

    • Multiple Choice

    • Date & Time

    • Phone

    • Number

    • File Upload & Image Upload

    • Ratings & Emoji

    • Product Choice

    • Hidden & Validation Fields

    • URL


4. Key Rules & Validation Requirements

⚠️ Important Integration Notes:


  • Consent Required: Subscribers will only be added to your email list if they explicitly check the consent element containing accepts_marketing. Unchecked submissions will not trigger a subscription.

  • Klaviyo API Permissions: Always ensure your Klaviyo Private API key has Full Access; restricted access keys may cause profile sync failures.









Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article