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:
  • View contacts: Browse all contacts in your list at /dashboard/contacts
  • Add contacts: Click Add Contacts to add one or multiple email addresses
  • Update contacts: Click on any contact to modify their subscription status
  • Delete contacts: Remove contacts individually from the contact table

2. Bulk File Upload

Import or delete contacts in bulk by uploading a CSV or JSON file:
  • Click Import Contacts in the contacts page
  • Select your file (CSV or JSON format)
  • Choose action: Add contacts or Delete contacts
For file format details, see the AWS documentation.

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>"

Update Contact

aws sesv2 update-contact \
  --region "<your-region>" \
  --contact-list-name "<your-contact-list-name>" \
  --email-address "<email-address>" \
  --unsubscribe-all

Delete Contact

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

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