Learn how Contact Import API email notifications work
The Contact Import API supports email notifications through the notify_callback parameter. One or more email addresses can be provided to receive updates about the upload status.
Note: The notify_callback parameter accepts email addresses only. Callback URLs and webhooks are not supported.
Once the upload is processed, Netcore sends an email notification indicating whether the upload was successful, partially successful, or failed.
The API request itself returns an immediate acknowledgement containing the request_id and, if applicable, a list of missing_attributes. The actual upload status is communicated through email.
Notification Types
Depending on the upload outcome, the notification email includes the following information:
| Notification Type | When It Is Sent | Information Included |
|---|---|---|
| Upload Successful | All data records are processed successfully. | Panel Name, Request ID, List Name, File Name, Total Records, Successful Upload |
| Upload Partial Success | Some records are uploaded successfully, while others fail validation or processing. | Panel Name, Request ID, List Name, File Name, Total Records, Successful Upload, Failed Records, Failure Reason |
| Upload Failed | The entire upload request cannot be processed, such as when the file does not contain a valid primary key column. | Panel Name, Request ID, List Name, File Name, Total Records, Failure Reason |
Partial Uploads
When an upload is partially successful, valid records are processed while records that fail validation are excluded.
For example, if a CSV file contains 4 data records and 1 header row, the notification may report:
- Total Records: 5
- Successful Upload: 3
- Failed Records: 1
The Total Records count includes the header row. Successful Upload and Failed Records count only data records.
To identify the records that failed and understand the reasons, use the download link provided in the notification email or access the Failure Report under Audience > All Contacts > Contact Logs.
Note: The failure report download link is available for 3 days. After this period, the link expires and the file is automatically deleted.
Sample Notifications
The following examples showcases the email notifications received for different upload outcomes.
Upload Successful
Subject: Contact Data Upload Successful
Contact Data Upload Status
Dear Associate,
The data upload request has been successfully processed.
The following information is provided for reference:
| Field | Sample Value |
|---|---|
| Panel Name | <panel_name> |
| Request ID | <request_id> |
| List Name | <list_name> |
| File Name | contacts.csv |
| Total Records | 5 |
| Successful Upload | 4 |
All data records have been uploaded successfully.
Best Regards,
Team Netcore Cloud
Upload Partial Success
Subject: Contact Data Upload Partial Success
Contact Data Upload Status
Dear Associate,
The data upload request has been partially processed. Some records were uploaded successfully, while others could not be processed due to invalid or mismatched data.
The following information is provided for reference:
| Field | Sample Value |
|---|---|
| Panel Name | <panel_name> |
| Request ID | <request_id> |
| List Name | <list_name> |
| File Name | contacts.csv |
| Total Records | 5 |
| Successful Upload | 3 |
| Failed Records | 1 |
Failure Reason: The identified records may contain invalid data or inconsistent attribute values, such as values that do not match the recommended data type.
To access the records that could not be uploaded, download the failure report using the link provided in the email.
Note: The download link is available for 3 days, after which it expires and the file is automatically deleted.
Best Regards,
Team Netcore Cloud
Upload Failed
Subject: Contact Data Upload Failed
Contact Data Upload Status
Dear Associate,
The data upload request could not be processed.
The following information is provided for reference:
| Field | Sample Value |
|---|---|
| Panel Name | <panel_name> |
| Request ID | <request_id> |
| List Name | <list_name> |
| File Name | contacts.csv |
| Total Records | 4 |
Failure Reason: Primary key not found in file.
Please verify the file and ensure that it contains the required primary key column before retrying the upload.
