Aggregation and Collection
Contacts CSV Upload
How to import and update contacts via CSV upload
Navigation
Access at: https://app.monterey.ai/w/default/feedback/contacts
Or follow these steps:
- Log into the Monterey.ai dashboard
- Navigate to Contacts
- Click the ”+ Contact” button in the top right corner
You must have the appropriate permissions to access the contacts import feature. Contact your workspace administrator if you cannot access this section.
CSV Format
Your CSV file should contain the following columns:
contactName
- The contact’s full namecontactEmail
- The contact’s email addresscontactAccountName
- The associated account/company namecontactAccountDomain
- Associated company’s domain (e.g., “example.com”)contactSourceId
- External identifier for the contactcontractValue
- Associated contract value (numeric)Account {X}
/account_{X}
prefix - Columns withAccount {X}
oraccount_{X}
prefix will be stored as metadata on the associated account- Additional columns - Any other columns will be stored as metadata
Example CSV
How Contacts Are Matched
Contact Matching Logic
- If
contactSourceId
is provided:- Matches against existing contact with the same source ID
- Otherwise, attempts to match on:
- Contact email address
- Contact name
Account Association
For each contact:
- Attempts to match existing account by domain
- If no domain match, tries matching by account name
- Creates new account if no matches found and account info provided
Required Fields
You must provide at least one of:
contactEmail
contactSourceId
Rows missing both fields are invalid and will be skipped during import.
Best Practices
- Include source IDs if available for precise matching.
- Provide account domains for accurate account association.
- Use consistent naming for accounts
- Include any additional fields you want to track as metadata columns.
- Review your CSV data before upload to ensure accuracy.
What Happens During Import
- System validates all rows in your CSV.
- For each valid row:
- Checks for valid contact name or email
- Attempts to match existing contacts by source ID or email
- Links or creates associated account by domain/name
- Updates matched records or creates new ones
- Preserves existing data while adding new data
Supported File Types
The account import accepts the .csv
and .xlsx
files