Data Hub connection
The Data Hub source connector is available as a limited availability (Beta) release.
The Boomi Data Hub source connector connects Data Integration pipelines directly to a Data Hub repository. You can use this connector to extract golden records from one or more Universe models and deliver them to a downstream target without building custom REST logic.
Each connection is scoped to a single repository. You only view Universe models that belong to the connected repository.
The connector supports two delivery modes:
| Mode | How it works | Latency |
|---|---|---|
| Standard extraction | Data Integration pulls golden records from the Data Hub Repository API on each run. | Minutes to hours |
| Change data capture (CDC) | Data Hub streams golden record changes (creates, updates, deletes) to Boomi Event Streams in real time, and Data Integration consumes them as they occur. | Sub-second |
This page covers connecting in both modes. To build and activate a data flow with an existing connection, refer to Data Hub walkthrough.
Prerequisites
Before you set up a Data Hub connector connection, make sure you have the following:
- Access to a Boomi Data Hub repository
- A Data Integration account with connector configuration permissions
To use CDC, you also need:
- Boomi Event Streams and Data Hub Real-Time Outbound Messaging provisioned on your Boomi account
- An administrative user role that includes the
MDM - View RepositoriesandMDM - Repository Managementprivileges - The target Universe model published and deployed in the repository. Data Integration does not deploy models on your behalf. If a selected model is not deployed, activation fails with an error telling you to deploy it first.
Setting up a standard connection
Follow this procedure to extract golden records on a schedule using standard extraction. To stream changes in real time instead, refer to Setting up a CDC connection.
Step 1: Locating your connection parameters in Data Hub
- Log in to Boomi Data Hub.
- Open the repository you want to connect to.
- Click the Configure tab. For more information, refer to Viewing repository information.
- Note the Base URL, Username, and My Hub Authentication Token values.
Step 2: Configuring the connection in Data Integration
- Navigate to the Data Integration Console.
- Click Connections from the left-hand menu.
- Click + New Connection.
- Find and select the Data Hub source.
- Enter the Connection Name.
- Enter the values you noted in Step 1.
| Field | Description | Required |
|---|---|---|
| Base URL for API Requests | The Hub Cloud endpoint for your repository. | Yes |
| Username | Your Boomi Account ID. Refer to Viewing repository information. | Yes |
| My Hub Authentication Token | The secret token for your repository. Refer to Repositories overview. | Yes |
Regenerating the token immediately invalidates all existing integrations that use the previous token. Before regenerating, notify all teams that rely on connections to this repository.
- Click Test Connection.
- Click Save.
Troubleshooting standard connection errors
| Error | Likely cause | Resolution |
|---|---|---|
| 401 Unauthorized | Invalid or expired My Hub Authentication Token | Verify the token on the repository Configure tab. If the token has been regenerated, update all connections that use the old token. |
| 403 Forbidden | The Boomi Account ID does not have access to this repository | Confirm the Username is the correct Boomi Account ID for this repository. Contact your Data Hub administrator to verify permissions. |
| 404 Not Found | Incorrect Base URL or region selection | Verify that you selected the Hub Cloud region that hosts the target repository. |
Setting up a CDC connection
For end-to-end setup instructions for Change Data Capture (CDC) mode, refer to Data Hub: CDC Flow set up guide.