What is this feature?
Before using contacts in PostGrid, you’ll need to upload them from a structured CSV file. Each row represents a contact, and each column corresponds to a field such as name, address, or custom data. PostGrid validates these fields during upload and flags any rows that need corrections.
How can I use it?
To upload your contacts:
Step 1: Navigate to the Contacts Section
From your PostGrid dashboard, click on "Contacts" in the left-hand navigation menu.
Step 2: Upload Your CSV File
Click "Upload Contacts," then select "Upload CSV File" and choose your prepared CSV from your device.
Step 3: Review the Import Results
PostGrid will process the file and display your imported contacts. If any rows fail validation, PostGrid will highlight the errors or allow you to download a detailed error report for review.
Tip: The upload dialog includes a sample CSV you can download to model your file structure.Tip: The upload dialog includes a sample CSV you can download to model your file structure.
Common Errors and How to Fix Them
Q1: “There is 1 row missing an address, country code, a name/company name. This will be skipped.”
Cause: A contact is missing required information:
A valid address (street, city, state, zip)
A two-letter country code (ISO alpha-2, e.g., “US”, “CA”)
At least one identifier (First + Last Name, or Company Name)
Solution:
Ensure the country code is in two-letter format (e.g., change “United States” → “US”).
Fill in missing address fields.
Make sure each row has either a full name or a company name.
Example from video: Updating “United States” to “US” and adding a missing country code fixed the issue.
Q2: “receiver.variableMapping.is.invalid: Your object may only contain strings as keys and values.”
Cause: Custom field (column header) contains a period (.), which PostGrid does not allow in merge variable names.
Solution:
Rename the column header to remove the period. Use underscores or plain text instead.
Example:
my.code→my_codeormycode
Example from video: Changing my.code to my_code resolved the error.
Q3: “Email must be an email” (shown in Downloaded Error Report)
Cause: A value in the Email column is not a valid email format (e.g., “N/A”, “None”, or other text).
Solution:
If the contact has no email, leave the cell blank (do not enter placeholders).
If the email is intended to be valid, correct the formatting.
Example from video: Removing “N/A” and leaving the cell empty fixed the failure.
Important Note: You can download a detailed error report after upload to review all failed rows and their specific issues before re-uploading.
FAQs
Q: Why are some rows skipped during upload?
A: Rows are skipped when required fields are missing or invalid. This includes a missing address, an incorrectly formatted country code, or no name or company name provided. Download the error report after upload to see exactly which rows failed and why.
Q: Can I re-upload a corrected CSV after fixing errors?
A: Yes. After reviewing the error report, make the necessary corrections to your CSV file and upload it again through the Contacts section.
Q: Where can I find a sample CSV to use as a template?
A: The upload dialog includes a downloadable sample CSV that shows the correct column structure and formatting for your contacts file.