Notify Callback

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 TypeWhen It Is SentInformation Included
Upload SuccessfulAll data records are processed successfully.Panel Name, Request ID, List Name, File Name, Total Records, Successful Upload
Upload Partial SuccessSome 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 FailedThe 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:

FieldSample Value
Panel Name<panel_name>
Request ID<request_id>
List Name<list_name>
File Namecontacts.csv
Total Records5
Successful Upload4

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:

FieldSample Value
Panel Name<panel_name>
Request ID<request_id>
List Name<list_name>
File Namecontacts.csv
Total Records5
Successful Upload3
Failed Records1

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:

FieldSample Value
Panel Name<panel_name>
Request ID<request_id>
List Name<list_name>
File Namecontacts.csv
Total Records4

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.