Newsletter Platform Integration

DigiBlocks includes powerful newsletter integration capabilities that allow you to connect your Newsletter blocks directly with popular email marketing platforms. This integration enables visitors to subscribe to your mailing lists seamlessly without leaving your website.

Supported Newsletter Platforms

DigiBlocks supports integration with six major email marketing platforms:

• MailChimp – Popular email marketing service with robust automation features
• ActiveCampaign – Advanced email marketing and customer experience automation
• Brevo (formerly Sendinblue) – All-in-one digital marketing platform
• Klaviyo – E-commerce focused email and SMS marketing platform
• ConvertKit – Creator-focused email marketing platform
• MailerLite – Simple and affordable email marketing solution

How Newsletter Integration Works

When you configure a newsletter platform in DigiBlocks settings, any Newsletter block on your website will automatically connect to your chosen service. Visitors who submit the newsletter form will be added directly to your specified mailing list or audience.

The integration handles:

• Email validation and verification
• Duplicate subscriber prevention
• Error handling and user feedback
• Optional double opt-in processes
• Tag assignment for subscriber segmentation

General Setup Process

Before configuring any specific platform, follow these general steps:

1. Navigate to DigiBlocks > Settings in your WordPress dashboard
2. Scroll down to the Newsletter Settings section
3. Select your preferred platform from the dropdown menu
4. Configure the platform-specific settings that appear
5. Save your settings
6. Test the integration using a Newsletter block

MailChimp Configuration

MailChimp is one of the most popular email marketing platforms. Here’s how to set it up with DigiBlocks:

Getting Your MailChimp Credentials

1. Log in to your MailChimp account
2. Navigate to Account > Extras > API keys
3. Click Create A Key to generate a new API key
4. Copy the generated API key for use in DigiBlocks

Finding Your Audience ID

1. Go to Audience > All contacts in MailChimp
2. Click Settings and then Audience name and defaults
3. Look for the Audience ID in the right sidebar
4. Copy this ID for use in DigiBlocks settings

DigiBlocks Configuration

1. Set Newsletter Platform to MailChimp
2. Enter your MailChimp API Key in the designated field
3. Enter your Audience ID
4. Tags (Optional): Add comma-separated tags to automatically assign to new subscribers
5. Double Opt-in: Enable this if you want subscribers to confirm their email address before being added to your list

MailChimp Settings Summary

• API Key: Required for authentication with MailChimp
• Audience ID: Specifies which mailing list to add subscribers to
• Tags: Optional tags for subscriber segmentation
• Double Opt-in: Requires email confirmation before subscription is complete

ActiveCampaign Configuration

ActiveCampaign offers advanced automation features and requires both an API URL and API key for integration.

Getting Your ActiveCampaign Credentials

1. Log in to your ActiveCampaign account
2. Go to Settings > Developer
3. Copy your API URL (usually in format: https://youraccountname.api-us1.com)
4. Copy your API Key from the same page

Finding Your List ID

1. Navigate to Lists in your ActiveCampaign dashboard
2. Click on the list you want to use
3. The List ID will be visible in the URL or list details
4. Copy this ID for DigiBlocks configuration

DigiBlocks Configuration

1. Set Newsletter Platform to ActiveCampaign
2. Enter your API URL (including https://)
3. Enter your API Key
4. Specify the List ID where subscribers should be added
5. Tags (Optional): Add comma-separated tags for subscriber organization

Brevo (Sendinblue) Configuration

Brevo offers email marketing with additional SMS capabilities.

Getting Your Brevo API Key

1. Log in to your Brevo account
2. Go to SMTP & API > API Keys
3. Click Generate a new API key
4. Give it a name and copy the generated key

Finding Your List ID

1. Navigate to Contacts > Lists in Brevo
2. Click on your desired list
3. The List ID will be shown in the list details or URL
4. Copy this ID for configuration

DigiBlocks Configuration

1. Set Newsletter Platform to Brevo
2. Enter your Brevo API Key
3. Enter the List ID where subscribers should be added

Klaviyo Configuration

Klaviyo is particularly popular for e-commerce businesses and integrates well with online stores.

Getting Your Klaviyo Private API Key

1. Log in to your Klaviyo account
2. Navigate to Account > Settings > API Keys
3. Click Create Private API Key
4. Copy the generated private key

Finding Your List ID

1. Go to Lists & Segments in Klaviyo
2. Click on your desired list
3. The List ID can be found in the URL or list settings
4. Copy this ID for DigiBlocks

DigiBlocks Configuration

1. Set Newsletter Platform to Klaviyo
2. Enter your Private API Key
3. Enter the List ID for subscriber additions

ConvertKit Configuration

ConvertKit is designed specifically for content creators and online course creators.

Getting Your ConvertKit Credentials

1. Log in to your ConvertKit account
2. Go to Settings > Advanced
3. Copy your API Key from this page

Finding Your Form ID

1. Navigate to Grow > Landing Pages & Forms
2. Click on the form you want to use
3. The Form ID will be visible in the form settings or URL
4. Copy this ID for configuration

DigiBlocks Configuration

1. Set Newsletter Platform to ConvertKit
2. Enter your ConvertKit API Key
3. Enter the Form ID where subscribers should be added
4. Tags (Optional): Add comma-separated tags for subscriber segmentation

MailerLite Configuration

MailerLite offers a user-friendly interface with powerful automation features.

Getting Your MailerLite Token

1. Log in to your MailerLite account
2. Go to Integrations > Developer API
3. Generate a new API Token
4. Copy the token for DigiBlocks configuration

Finding Your Group ID

1. Navigate to Subscribers > Groups in MailerLite
2. Click on your desired group
3. The Group ID will be shown in the group details
4. Copy this ID for configuration

DigiBlocks Configuration

1. Set Newsletter Platform to MailerLite
2. Enter your MailerLite Token
3. Enter the Group ID where subscribers should be added

Using the Newsletter Block

Once you’ve configured your newsletter platform, you can use the Newsletter block anywhere on your website:

Adding a Newsletter Block

1. Edit any page or post with the block editor
2. Click the + button to add a new block
3. Search for “Newsletter” or find it in the DigiBlocks category
4. Click to add the Newsletter block to your content

Customizing the Newsletter Block

The Newsletter block offers several customization options:

• Title and description text
• Button text and styling
• Form field placeholder text
• Success and error messages
• Colors and typography
• Spacing and alignment

Form Behavior

When properly configured, the newsletter form will:

1. Validate the email address format
2. Check for existing subscribers (platform dependent)
3. Add the subscriber to your specified list
4. Display success or error messages
5. Optionally trigger double opt-in emails

Testing Your Integration

After configuring your newsletter platform, it’s important to test the integration:

Basic Testing Steps

1. Add a Newsletter block to a test page
2. Publish the page and visit it on the frontend
3. Enter a test email address and submit the form
4. Check your newsletter platform to confirm the subscriber was added
5. Verify any tags or list assignments are correct

Testing Double Opt-in

If you’ve enabled double opt-in (MailChimp):

1. Use a real email address you can access
2. Submit the newsletter form
3. Check your email for the confirmation message
4. Click the confirmation link
5. Verify the subscriber appears as confirmed in your platform

Error Testing

Test error scenarios to ensure proper handling:

1. Try submitting an invalid email address
2. Test with an email that’s already subscribed
3. Temporarily enter incorrect API credentials to test error messages

Best Practices

Security Considerations

• Store API keys securely and never share them publicly
• Use environment variables for API keys in staging/production environments
• Regularly rotate API keys for enhanced security
• Monitor API usage to detect any unusual activity

List Management

• Use descriptive tags to segment subscribers from different sources
• Set up appropriate welcome sequences for new subscribers
• Regularly clean your lists to maintain good deliverability
• Respect subscriber preferences and provide easy unsubscribe options

Form Optimization

• Keep newsletter forms simple with minimal required fields
• Use compelling copy to encourage subscriptions
• Place newsletter forms strategically throughout your site
• A/B test different form designs and copy

Compliance

• Ensure compliance with GDPR, CAN-SPAM, and other relevant regulations
• Include clear privacy policy links
• Obtain proper consent before adding subscribers
• Provide transparent information about email frequency and content

Troubleshooting Common Issues

Subscribers Not Being Added

If subscribers aren’t being added to your lists:

1. Check API credentials: Verify your API key and other credentials are correct
2. Verify List/Audience IDs: Ensure you’re using the correct list or audience ID
3. Check platform quotas: Some platforms have rate limits or subscriber limits
4. Review error logs: Check browser console for JavaScript errors

Double Opt-in Not Working

For MailChimp double opt-in issues:

1. Check spam folders: Confirmation emails might be filtered
2. Verify sender domains: Ensure your domain is properly authenticated
3. Review MailChimp settings: Check your audience’s double opt-in configuration
4. Test with different email providers: Some providers handle emails differently

Invalid API Responses

If you’re receiving API errors:

1. Check API key permissions: Ensure your API key has the necessary permissions
2. Verify endpoint URLs: Some platforms require specific API endpoint formats
3. Review rate limits: You might be hitting API rate limits
4. Check platform status: The newsletter platform might be experiencing issues

Form Styling Issues

If the newsletter form doesn’t match your site design:

1. Use theme-compatible styling: Ensure your theme doesn’t override DigiBlocks styles
2. Check for CSS conflicts: Other plugins might interfere with form styling
3. Customize block styles: Use the block editor’s styling options
4. Add custom CSS: Target specific elements with additional CSS if needed

This comprehensive setup ensures your DigiBlocks Newsletter integration works seamlessly with your chosen email marketing platform, providing a smooth subscription experience for your visitors while maintaining proper list management and compliance standards.