The account settings email address collection and resource allows you to retrieve a list of registered email addresses on your account as specified in the Settings in the UI. These email addresses are used in conjunction with campaign resource to specify From Email and Reply To email addresses.

To learn more about how to use email address collectino and resource, refer to Retrieving Account Email Addresses.

Account Email Addresses Collection

The email addresses collection gives you a list of email addresses you registered with your account in the Settings.  Each <entry> represents an email address and gives you a summary of each email address.

Request Format

GET https://api.constantcontact.com/ws/customers/{user-name}/settings/emailaddresses

For more detailed description about the above URI, please refer to the URI Format description.

To learn more about how to retrieve a list of email addresses registered in your account, please refer to Retrieving Account Email Addresses.

Response Format

<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <id>http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses</id>
  <title type="text" />
  <link href="http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses" />
  <link href="http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses" rel="self" />
  <author>
    <name>joesflowers</name>
  </author>
  <updated>2009-10-01T20:18:22.775Z</updated>
  <entry>
    <link href="/ws/customers/joesflowers/settings/emailaddresses/1" rel="edit" />
    <id>http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses/1</id>
    <title type="text">joesflowers@example.com</title>
    <updated>2009-05-21T17:44:04.609Z</updated>
    <author>
      <name>Constant Contact</name>
    </author>
    <content type="application/vnd.ctct+xml">
      <Email xmlns="http://ws.constantcontact.com/ns/1.0/" id="http://api.constantcontact.
      com/ws/customers/joesflowers/settings/emailaddresses/1">
        <EmailAddress>joesflowers@example.com</EmailAddress>
        <Status>Verified</Status>
        <VerifiedTime>2009-05-21T17:44:04.609Z</VerifiedTime>
      </Email>
    </content>
  </entry>
  <entry>
    <link href="/ws/customers/joesflowers/settings/emailaddresses/2" rel="edit" />
    <id>http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses/2</id>
    <title type="text">joesflowers2@example.com</title>
    <updated>2009-09-02T13:27:36.552Z</updated>
    <author>
      <name>Constant Contact</name>
    </author>
    <content type="application/vnd.ctct+xml">
      <Email xmlns="http://ws.constantcontact.com/ns/1.0/" id="http://api.constantcontact.
      com/ws/customers/joesflowers/settings/emailaddresses/2">
        <EmailAddress>joesflowers2@example.com</EmailAddress>
        <Status>Pending</Status>
      </Email>
    </content>
  </entry>
</feed>

Each <entry> represents an email address registered with the account.  Its unique ID is givein in <id> element while the link to get more of its detail is given in <link> element with rel attribute of "edit".

For more detailed descriptions of the XML elements, refer to the Email Address Elements Data section.

Account Email Address Resource

The account email address represents an email address that has been registered in your account.

Request Format

GET https://api.constantcontact.com/ws/customers/{user-name}/settings/emailaddresses/{email-id}

 For more detailed description about the above URI, please refer to the URI Format description.

To learn more about how to retrieve a list of email addresses registered in your account, please refer to Retrieving Account Email Addresses.

Response Format

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns="http://www.w3.org/2005/Atom">
  <link href="/ws/customers/joesflowers/settings/emailaddresses/1" rel="edit" />
  <id>http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses/1</id>
  <title type="text">joesflowers@example.com</title>
  <updated>2009-05-21T17:44:04.609Z</updated>
  <author>
    <name>Constant Contact</name>
  </author>
  <content type="application/vnd.ctct+xml">
    <Email xmlns="http://ws.constantcontact.com/ns/1.0/" id="http://api.constantcontact.
    com/ws/customers/joesflowers/settings/emailaddresses/1">
      <EmailAddress>joesflowers@example.com</EmailAddress>
      <Status>Verified</Status>
      <VerifiedTime>2009-05-21T17:44:04.609Z</VerifiedTime>
    </Email>
  </content>
  <source>
    <id>http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses</id>
    <title type="text" />
    <link href="http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses" />
    <link href="http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses" rel="self" />
    <author>
      <name>joesflowers</name>
    </author>
    <updated>2009-10-01T21:06:25.486Z</updated>
  </source>
</entry>

For more detailed descriptions of the XML elements, refer to the Email Address Elements Data section.

URI Format

Email Address Elements Data