Contacts

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:

Click Import Contacts in the contacts page
Select your file (CSV or JSON format)
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>"

import * as AWS from "@aws-sdk/client-sesv2";

const client = new AWS.SESv2({
  region: "<your-region>",
});

const { Contacts } = await client.listContacts({
  ContactListName: "<your-contact-list-name>",
  PageSize: 100,
});

Get Contact

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

import * as AWS from "@aws-sdk/client-sesv2";

const client = new AWS.SESv2({
  region: "<your-region>",
});

const contact = await client.getContact({
  ContactListName: "<your-contact-list-name>",
  EmailAddress: "<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>"}'

import * as AWS from "@aws-sdk/client-sesv2";

const client = new AWS.SESv2({
  region: "<your-region>",
});

await client.createContact({
  ContactListName: "<your-contact-list-name>",
  EmailAddress: "<email-address>",
  AttributesData: {
    "<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>"}'

import * as AWS from "@aws-sdk/client-sesv2";

const client = new AWS.SESv2({
  region: "<your-region>",
});

await client.updateContact({
  ContactListName: "<your-contact-list-name>",
  EmailAddress: "<email-address>",
  AttributesData: {
    "<key>": "<value>",
  },
});

Delete Contact

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

import * as AWS from "@aws-sdk/client-sesv2";

const client = new AWS.SESv2({
  region: "<your-region>",
});

await client.deleteContact({
  ContactListName: "<your-contact-list-name>",
  EmailAddress: "<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

Getting started

Learn

Resources

Managing Contacts

1. Console Management

2. Bulk File Upload

3. AWS SES API

List Contacts

Get Contact

Add Contact

Update Contact

Delete Contact

Attribute Data

Where Contacts Are Stored

Additional resources

​Managing Contacts

​1. Console Management

​2. Bulk File Upload

​3. AWS SES API

​List Contacts

​Get Contact

​Add Contact

​Update Contact

​Delete Contact

​Attribute Data

​Where Contacts Are Stored

​Additional resources

Managing Contacts

1. Console Management

2. Bulk File Upload

3. AWS SES API

List Contacts

Get Contact

Add Contact

Update Contact

Delete Contact

Attribute Data

Where Contacts Are Stored

Additional resources