From our Contacts page, you can add, upload, modify, and delete your contacts. Contacts can be added to your contacts database using the API, or by manually adding or uploading a CSV file through the SendGrid App.
Your first 2,000 contacts are free. After 2,000 contacts, SendGrid charges $10 for every additional 10,000 contacts.
You can easily add contacts to your contact database by uploading a CSV of your contacts to SendGrid. If you have your contacts in a spreadsheet, simply save that sheet as a .csv file using a spreadsheet application like Microsoft Excel or Google Sheets. You can also export your contacts from most database systems as a .csv file.
To add new contacts:
Click Add Contacts and then select Upload CSV.
Choose an existing list or create a new list.
If you choose to add the contacts without assigning them to a list, they exist in the contacts database without any additional context.
Upload your file by dragging it into or clicking the CSV upload area.
Once the CSV has populated, click Next: Custom Fields.
A page appears displaying the data from the header row of the CSV file. From the list, you can select a custom field to associate with the data in the column. If there isn't a corresponding field, you can add one. Only the Email field is required to complete the upload. Skipped column headers are not uploaded and do not appear as custom fields within an individual contact's profile.
Select Skip Column to omit data from the contacts list.
Once you've gone through all of the headers, click Next: Add Contacts.
After uploading contacts, you can define segments for individual contacts or lists based on specified criteria. For more information, see Segmenting Your Contacts.
The maximum CSV file size is 2GB.
Once we have completed processing your new contacts, you will receive an email to any addresses specified under Notifications. If there is no email address specified for notifications, the report will go to the address associated with the account by default. To add an additional notification email address, click Add Notification Email Address
The notification email contains the following information:
If there are any errors, there will be a link to download a CSV containing the errored rows so that you can reformat and reupload those contacts. For more help resolving issues with uploading a CSV, see Formatting a CSV.
The download link to your CSV of errored rows will be available for 24 hours.
If you upload the same contact more than once, SendGrid updates the data, assuming the most recent upload has the most up-to-date information. Updates to your contacts cannot be rolled back. Multiples of the same contact (as identified by email) can be added to different lists or segments and count as one contact against your total contacts per account or subuser account.
To manually add a contact to your contact database:
To add Custom Field data to a manually imported contact, navigate to the Contact Details page of the new contact.
To create a new list:
To manually add contacts to an existing list:
If you create a segment before you upload a list, contacts that fit the segment criteria populate that segment when uploaded.