Skip to main content

​
Managing Contacts

Contacts are the email addresses you send emails to. It provides three ways to manage your contacts.

​
1. Console Management

Add, view, and manage contacts directly through the web interface:

​
2. Bulk File Upload

Import or delete contacts in bulk by uploading a CSV or JSON file:
  1. Click Import Contacts in the contacts page
  2. Select your file (CSV or JSON format)
  3. Choose action: Add contacts or Delete contacts
CSV format
emailAddress,unsubscribeAll,attributesData
john.doe@example.com,false,"{""Name"": ""John"", ""Company"": ""ACM Inc""}"
jane.smith@example.com,true,"{""Name"": ""Jane"", ""Company"": null}"
JSON format
{
     "emailAddress": "john.deo@example.com",
     "unsubscribeAll": false,
     "attributesData": "{\"Name\":\"John\"}"
}
{
     "emailAddress": "jane.smith@example.com",
     "unsubscribeAll": true,
}

​
3. AWS SES API

Access contacts programmatically using AWS SES APIs. You can use your prefered language to manage your contacts. Click AWS API in the contacts page to get your specific region and contact list name.

​
List Contacts

aws sesv2 list-contacts \
  --region "<your-region>" \
  --contact-list-name "<your-contact-list-name>"

​
Get Contact

aws sesv2 get-contact \
  --region "<your-region>" \
  --contact-list-name "<your-contact-list-name>" \
  --email-address "<email-address>"

​
Add Contact

aws sesv2 create-contact \
  --region "<your-region>" \
  --contact-list-name "<your-contact-list-name>" \
  --email-address "<email-address>" \
  --attributes-data '{"<key>": "<value>"}'

​
Update Contact

aws sesv2 update-contact \
  --region "<your-region>" \
  --contact-list-name "<your-contact-list-name>" \
  --email-address "<email-address>" \
  --attributes-data '{"<key>": "<value>"}'

​
Delete Contact

aws sesv2 delete-contact \
  --region "<your-region>" \
  --contact-list-name "<your-contact-list-name>" \
  --email-address "<email-address>"

​
Attribute Data

Attribute data is custom key-value pairs that you can attach to each contact. This allows you to store additional information about your contacts, such as their name, company, or any other relevant data.
Attribute data must be a JSON object.

​
Where Contacts Are Stored

Contacts are stored in AWS SES Contact Lists, not in our database. This means:
  • Your contact data never leaves your AWS account
  • You have full ownership and control of your contacts
  • Direct access to your contacts through AWS SES APIs

​
Additional resources