​

Integrations

Integrations allow you to connect Fanfare with external services like marketing platforms, analytics tools, and e-commerce systems to enhance functionality and streamline workflows.

​

Accessing Integrations

Navigate to Settings > Integrations to view and manage your connected services. Caption: View and manage all available integrations

​

Available Integrations

​

Active Integrations

​

Coming Soon

​

Integration Status

Each integration shows its current status: Caption: Status indicators show connection health

​

Klaviyo Integration

Klaviyo integration enables marketing automation and audience synchronization.

​

Features

​

Setting Up Klaviyo

1. Click on the Klaviyo integration card
2. Enter your Klaviyo API key
3. Click Save to connect
4. Verify the connection status

Caption: Enter your Klaviyo API key to connect

​

Klaviyo API Key

To get your Klaviyo API key:

1. Log in to Klaviyo
2. Go to Settings > API Keys
3. Create a new Private API key
4. Copy the key

​

Required Permissions

Your Klaviyo API key needs these permissions:

​

Synced Data

When Klaviyo is connected, the following data syncs:

​

Managing Klaviyo Connection

After connecting:

​

Integration Configuration

​

Connection Process

1. Click on an integration card
2. Configuration sheet opens
3. Enter required credentials
4. Save the configuration
5. Integration activates

​

Credential Security

Integration credentials are:

• Encrypted at rest
• Never displayed after saving
• Stored securely
• Accessible only to admins

​

Synced Audiences

When audiences are imported from integrations: Caption: Synced audiences show their integration source

​

Event Forwarding

Forward Fanfare events to integrated services:

​

Supported Events

​

Event Mapping

Configure how Fanfare events map to integration events:

​

Troubleshooting Integrations

​

Connection Failed

1. Verify API credentials are correct
2. Check the service status
3. Ensure required permissions are granted
4. Try reconnecting

​

Sync Not Working

1. Check the connection status
2. Verify data exists in the source
3. Force a manual sync
4. Review error logs

​

Data Mismatch

1. Check field mapping configuration
2. Verify data formats match
3. Review conflict resolution settings
4. Contact support if issues persist

​

Integration Best Practices

​

Before Connecting

1. Verify permissions - Ensure API key has required access
2. Document the setup - Record configuration details
3. Test in staging - If available, test first
4. Notify team - Inform relevant team members

​

After Connecting

1. Monitor sync status - Check regularly for errors
2. Review synced data - Verify data accuracy
3. Set up alerts - Configure error notifications
4. Regular audits - Periodically review connections

​

Security Considerations

1. Rotate credentials - Update API keys periodically
2. Limit permissions - Grant only necessary access
3. Audit access - Review who can manage integrations
4. Remove unused - Disconnect unused integrations

​

Webhook Configuration

Some integrations support webhooks for real-time updates:

​

Related Guides

• Settings Overview - All settings
• Audiences - Managing audiences
• Import Consumers - Importing from integrations