BlueConic Experiences allows you to configure more than one instance of the same integration within a single workspace. Each instance is independently named, configured, and managed — allowing teams to maintain separate credentials, mappings, and settings for different business units, regions, or data flows without conflict.
Before you begin
Ensure you have the necessary credentials for each instance you plan to configure.
Identify how you want to name each instance to distinguish it clearly (for example, by region, business unit, or use case).
Confirm that the integration you want to use supports multiple instances. Multiple instances are available across all supported integrations in BlueConic Experiences.
Add an integration instance
Navigate to Attributes > Integrations from within your experience.
Locate the integration you want to configure. If an instance already exists, the tile displays an instance count badge (for example, 2 Instances).
Select the integration tile. The Instances modal opens, listing all existing instances with their name, status, and date added.
Select + Add New Instance.
In the Integration Setup modal, complete the following:
Integration Name — enter a unique name to identify this instance (for example, "Klaviyo — EU" or "Braze — West Region").
Credentials — enter the credentials required for this instance (for example, List ID, API key).
Data Handling — configure the following toggles as needed:
Active — enables data sharing for this instance.
Send in preview — sends data while the experience is in preview mode.
Include UIDs — attaches unique identifiers to each record.
Require opt-in — only processes data from opted-in users.
Region — select US, EU, or All Regions.
Mappings — configure attribute mappings specific to this instance.
Additional Options — configure any instance-specific advanced settings.
Select Save.
View and manage existing instances
From the Instances modal, you can review all configured instances for a given integration at a glance. Each instance displays its name, endpoint or identifier, status (Active or Disabled), and the date it was added.
To edit an existing instance, select Edit next to the instance you want to update. Make your changes in the Integration Setup modal and select Save.
Next steps
Review each instance to confirm credentials, mappings, and data handling settings are accurate before activating.
Link each instance to the relevant experiences to ensure data is routing to the correct destination.
FAQ
Can I have instances with different attribute mappings under the same integration?
Yes. Each instance maintains its own independent mappings, credentials, and settings — changes to one instance do not affect others.
How do I disable an instance without deleting it?
In the Integration Setup modal, toggle Active off under Data Handling. The instance remains in your list with a Disabled status and can be reactivated at any time.