How matching works
When Hyperline syncs a customer with an external system, it first looks for an existing provider link on the Hyperline customer. If a link already exists, Hyperline updates or reads from that external record. If no link exists yet, the integration tries to find or create the external record according to the integration settings and the action being performed. Typical matching inputs include:- The external provider record ID already stored on the Hyperline customer
- The customer email, company name, tax ID, or other integration-specific fields
- The CRM object selected in the integration settings, such as a company or deal
- Payment-provider routing rules, such as the invoicing entity used for the customer
Matching rules can differ by provider. A CRM integration and a payment provider integration may not use the same identifier or create records at the same time.
Create versus update
Hyperline updates an external record when the Hyperline customer is already linked to that record. Hyperline creates a new external record only when the integration action and settings allow creation. For example:- If a customer is already linked to a CRM company, Hyperline syncs future quote or subscription data to that company.
- If a CRM action starts from a contact but the integration expects a company, Hyperline may need a company link before quote or subscription data can sync correctly.
- If a payment provider customer does not exist yet, Hyperline may create it only when a payment method, checkout, or payment flow requires it.
Countries and currencies
When importing customer details from a CRM, Hyperline checks the source country and currency against your Countries & currencies settings.- For a new customer, a missing or disallowed country or currency stays empty instead of being inferred from the invoicing entity or country.
- For an existing customer, Hyperline ignores disallowed source values and keeps the saved country and currency. Other mapped fields can still update.
Sync customer hierarchy
You can import parent–child relationships from your CRM into Hyperline. Follow the setup instructions for HubSpot or Salesforce, then use the shared review and troubleshooting workflow below. Hierarchy sync is not available for Attio.Hierarchy sync creates relationships without changing invoicing settings. To bill a child through its parent, configure organisation-based billing separately.
Review existing customers
Enabling hierarchy sync processes future CRM updates; it does not automatically update all existing customer relationships.- After saving the setting, click Review existing hierarchy.
- Review up to 25 linked customers, including proposed parent additions, changes or removals, and any blockers.
- Click Sync reviewed changes to queue changes for that batch.
- Click Review next batch to review more customers, when available.
Resolve blocked changes
Hyperline preserves relationships managed manually in Hyperline. It also blocks changes or removals that would affect parent billing or an ongoing quote, such as a subscription update quote. A CRM removal does not remove a link that is still needed for these workflows. If a change is blocked, open the integration’s View issues, resolve the cause, and retry the failed sync. For example:- Parent not synced: Sync or link the parent CRM record to a Hyperline customer, then retry.
- Manual relationship conflict: Review the parent relationship in Hyperline and reconcile it with the intended CRM hierarchy before retrying.
- Parent billing or quote dependency: Resolve the billing configuration or the ongoing quote before retrying a parent change or removal.
- Invalid hierarchy: Correct relationships that would make a customer its own parent or create a circular hierarchy in the CRM, then retry.
Why duplicates or wrong links happen
Duplicates or wrong links usually come from one of these situations:- The same customer exists more than once in the external system
- A CRM contact is used where the integration expects a company
- A Hyperline customer was manually linked to the wrong external record
- The customer changed invoicing entity or payment-provider account
- A previous sync failed before Hyperline saved the provider link
Fix a wrong or duplicate match
- Open the Hyperline customer
- Check which CRM or provider records are linked to the customer
- Open the external system and identify the correct record
- Remove duplicate external records if they should not exist
- Re-link or re-associate the Hyperline customer to the correct external record
- Retry the failed sync or send the record to the provider again
If “Send to CRM” does nothing
If a send or sync action appears to do nothing, check whether the expected external object exists and is linked. For CRM integrations, verify:- The company or deal exists in the CRM
- The Hyperline customer is linked to the expected CRM object
- The integration settings allow customer creation or linking
- The CRM user has permission to view and update the object
- The customer has the expected invoicing entity
- The payment-provider account for that invoicing entity is connected
- A payment method or checkout flow has created the external customer when required
When to contact support
Contact support if:- You cannot see or change the provider link from Hyperline
- The same external record is linked to multiple Hyperline customers
- A quote or subscription was created on the wrong customer
- Retrying the sync keeps targeting the wrong external record

