Import Your Book of Business
Import customer and policy data so Cora and your campaigns can support members with context.
With Customer Assignment automations configured, you are ready to import your book of business. This is the customer and policy data that empowers your AI employees to support your agency.
By importing your book, your Receptionist can support members 24/7: greeting them by first name, answering questions about their plan, and referencing their licensed agent in every conversation.
It also enables Retention Suite campaigns, because campaigns target the customers and policies that live in your book.
To import your book, start with CSV files from your existing CRM, policy management system, or carrier portals. Whatever format your CSV is in, careCycle's Import Contacts tool has you covered. The built-in AI mapping assistant handles non-standard column names automatically.
Before you start
To ensure your data is uploaded safely and correctly, contact your Forward Deployed Engineer or support@carecycle.ai before your first import. We will review your file and flag anything to adjust.
How Matching Works
careCycle uses upsert logic for all imports and syncs.
If a matching record already exists, it gets updated. If not, a new record is created. You can re-import or re-sync the same data without creating duplicates as long as the right identifiers are present.
In practice that means:
- Medicare books match customers by MBI number first, then by last name plus date of birth plus phone number.
- ACA books match customers by HealthSherpa ID, your system's ID, or the carrier's ID, then by last name plus date of birth plus phone number.
The exact matching cascades, plan code rules, and every accepted field and format live in the Book of Business Field Reference. You will want that page open while preparing your file.
Recommendation
Include externalId wherever possible. It links careCycle records back to
your system for future policy and commission tracking, and it helps prevent
duplicates across imports.
How This Data Is Used
The more complete your customer and policy records are, the more useful your AI employees can be.
Each field can trigger downstream activity including campaign automations, customer assignments, and task automations.
This data populates your Customers and Policies views in the careCycle CRM for
your team to reference when managing member needs. Fields like planCode are
used by Cora to reference the Summary of Benefits and answer plan questions,
while firstName is used to greet members by first name.
Data placed into careCycle may also power integrations in your instance, including enrollment platforms, CMS databases, and carrier reporting feeds.
Run the Import
Prepare your CSV
Download a CSV template to structure your data:
- Medicare Book of Business CSV Template
- ACA Book of Business CSV Template
Upload and map your columns
Open the Import Contacts tool and upload your file. The built-in data preparation agent formats your data and maps non-standard column names for a smooth import.
Review and confirm
Check the preview for anything unexpected, then run the import. Because imports are upserts, re-running the same file is safe.
Import Tips
- Pick one date format and stay consistent. Date fields accept both
MM/DD/YYYYandMM-DD-YYYY. - Every record needs
postalCodeortimezone. Without one, TCPA compliance checks block outbound campaigns for that contact. - Pre-suppress sensitive contacts. Use
doNotCallanddoNotSMSflags on import. - Include
externalIdfor round-tripping. It is how you match careCycle records back to your source system on future syncs. - HealthSherpa users: Include
healthSherpaPolicyId. It is the primary identifier for matching ACA policies on future syncs.