This article assumes your CRM is connected and account matching is complete. See Connect your CRM and Account matching if you haven’t done these yet.
Video walkthrough
See Starbridge University for a walkthrough.Step-by-step instructions
See Starbridge University for a step-by-step example creating and syncing a job changes custom object.1
Create the custom object in your CRM
Before configuring anything in Starbridge, create the custom object in your CRM:
- Define the object schema and fields — include the signal data you want to capture (for example, signal date, summary, type, recommended action, and talking points)
- Create a relationship (association) between the custom object and the Account or Company object so each signal record is linked to the right account
Your CRM admin will typically need to complete this step. Once the object exists in your CRM, it needs to be enabled in Starbridge before you can use it in a sync column — see the next step.
HubSpot: Managing relations (association limits)
HubSpot: Managing relations (association limits)
HubSpot supports flexible many-to-many associations, multiple association labels, and multiple related records per object. This introduces an important constraint for Starbridge integrations.Starbridge only supports relations where a given Starbridge-managed object can be associated to at most one other object of a given type. This applies to all HubSpot custom objects used in Starbridge syncs.For example, if you create a custom object called Job Change and associate it with the HubSpot Company object:
- A Company → many Job Changes is supported
- A Job Change → at most one Company is required
- Go to Settings → Objects and select the custom object.
- Choose the Associations tab.
- Select the association pair — for example, Job Change ↔ Company.
- Click Create and configure → Configure association limit. For the custom object → Company direction, set the limit to 1.
- Select Company ID (Relation to Company) in your sync column field mappings.
- Map it to your account lookup column.
- Starbridge writes the association when creating or updating the custom object record.
If the Company ID (Relation to Company) value isn’t available from your account lookup column when syncing contacts, see HubSpot-specific details.
2
Expose the custom object to Starbridge
Go to Settings → Integrations, open your CRM integration, and click Objects & fields. Enable the custom object and all the fields you want Starbridge to write to, including the relationship field that links the custom object to the Account or Company object.Save your changes and allow the resync to complete before proceeding.
3
Add an account lookup column to your bridge
In your bridge, click Add column → Configure integration → Lookup Record in CRM and select the Account or Company object.Enable Account matching to resolve the right CRM account for each buyer row automatically. This lookup is what associates each custom object record to the correct account — if no account is found, the sync column should not create a record.
4
Add a sync column for the custom object
Click Add column → Configure integration → Sync Record in CRM, select your custom object, and set the sync type to Create and manage record.
- Starbridge creates a new record in the custom object for each bridge row
- Enable Keep records up to date if you want Starbridge to update existing records when data in the bridge changes over time
5
Map Starbridge fields to the custom object
Map each Starbridge column to the corresponding custom object field. Include the Account or Company ID from your account lookup column, mapped to the relationship field — this is what associates each record to the right account.Set all mapped fields to Overwrite so Starbridge can keep records current if values change.
6
Add a run condition
Add a run condition: only run if the account lookup column’s Record ID is not empty. This ensures custom object records are always associated to a valid account and prevents orphan records from being created when no CRM account match is found.
7
Run the sync
Once your lookup column is resolving accounts consistently and your sync column is mapped, run the sync.Each cell updates to show Success, No action taken, or Error. Click into any cell to see a history of syncs for that row.
Next steps
What to sync with your CRM
Planning guide for deciding which data types to sync and where they should live.
Sync job changes to your CRM
A specific implementation of the custom object pattern for job change signals.